» 


从 技术 原理 到 编码 实践 
完整 介绍 以 太 坊 DApp 的 开发 流程 与 实践 
涵盖 钱包 、 交 易 所 与 智能 合约 的 开发 与 部 署 


林 冠 安 @ 着 


区 块 链 
以 太 坊 DApp 


ic: 


太 坊 DApp 


区 块 


VA 


ww 


A 


jt 


MNA OS 


内 容 简 介 


本 书 以 Go 编程 语言 讲解 ， 从 必要 的 理论 知识 到 编码 实践 ， 循 序 渐进 地 介绍 以 太 坊 DApp 开发 的 技术 要 
点 。 全 书 主要 内 容 分 4 大 部 分 : 第 一 部 分 介绍 区 块 链 的 一 些 重要 基础 知识 ; 第 二 部 分 全 面 地 介绍 以 太 坊 公 链 
的 应 用 基础 ， 内 容 包 含 但 不 限于 以 太 坊 的 大 量 术 语 ;， 第 三 部 分 介绍 以 太 坊 智能 合约 整体 开发 与 部 壮实 践 ;， 第 
四 部 分 以 以 太 坊 DApp 中 继 服 务 作为 综合 范例 ， 介 绍 以 太 坊 区 块 链 DApp 的 开发 流程 与 实战 。 

本 书 注重 应 用 , 代码 注释 详尽 ， 适 合 IT 技术 开发 者 阅读 ， 对 于 想 了 解 以 太 坊 及 其 DApp 开发 技术 的 人 员 
或 想 开 发 一 球 基 于 以 太 坊 的 DApp 开发 者 尤为 合适 。 


本 书 封面 贴 有 清华 大 学 出 版 社 防伪 标签 ， 无 标签 者 不 得 销售 。 
版 权 所 有 ， 侵 权 必 究 。 侵 权 举报 电话 : 010-62782989 13701121933 


图 书 在 版 编目 (CIP) 数据 


区 块 链 以 太 坊 DApp 开发 实战 / 林 冠 宏 著 . 一 北京 : 清华 大 学 出 版 社 ，2019 
ISBN 978-7-302-53126-5 


[ .OQ 区 … I.O- 了 H. 也 电子 商务 一 支付 方式 一 程序 设计 IV. DF713. 361. 39TP311. 1 
中 国 版 本 图 书馆 CIP 数据 核 字 (2019) 第 112868 号 


责任 编辑 : 王 金 柱 
封面 设计 : E # 
责任 校对 : HAE 
责任 印 制 : b de 


出 版 发 行 : 清华 大 学 出 版 社 
网 Hb: http://www. tup. com. cn, http://www. wqbook. com 
地 址 : 北京 清华 大 学 学 研 大 厦 A 座 AB ża: 100084 
4t 总 机 : 010-62770175 B W: 010-62786544 
投稿 与 读者 服务 : 010-62776969, c-service@tup. tsinghua. edu. cn 
质 8€ 反 馈 : 010-62772015, zhiliangtup. tsinghua. edu. cn 


Ep 装 者 : 北京 密云 胶印 三 

经 销 : 全 国 新 华 书店 

JF ”本 : 190mmX 260mm Ep — 53K: 16 Z 334. 409 TE 

版 次 : 2019 年 8 月 第 1 版 E] 次 : 2019 年 8 月 第 1 次 印刷 
Æ 价 : 79.00 元 


产品 编号 : 082466-01 


nii 


EDI 


出 版 这 本 书 之 前 ， 我 是 一 位 已 经 撰写 技术 博文 5 年 之 久 的 程序 员 ， 技 术 栈 范围 包含 但 不 限于 
安 早 应 用 开发 、 后 问 开 发 以 及 现在 所 从 业 的 区 块 链 DApp 开发 。 

时 经 有 个 少 出 版 社 联 系 我 出 书 ， 但 限于 对 知识 的 冤 上 其 和 对 出 书 的 谨慎， 都 一 一 婉拒 了 。 正 式 
签约 出 版 这 本 书 是 2018 年 10 月 中 旬 , 那 时 我 处 于 一 个 对 区 块 链 和 以 太 坊 知识 非常 热衷 的 阶段 ， 当 
时 的 工作 也 正好 是 基于 区 块 链 做 各 种 DApp 的 开发 , 比如 具有 代表 性 的 钱包 、 中心 化 交易 所 和 去 中 
心 化 交易 所 应 用 。 对 区 块 链 、 以 太 坊 的 各 个 方面 构建 了 一 套 完 整 的 知识 体系 , 所 以 在 清华 大 学 出 版 
社 的 编辑 联系 我 的 时 候 , 市 面 上 关于 以 太 坊 DApp 技术 开发 的 书籍 几乎 为 零 , 而 理论 性 的 书籍 过 多 ， 
在 深思 熟 虑 之 后 ， 便 决定 编写 此 书 。 

写 书 最 怕 的 是 误 人 子弟 。 后 面 正 式 编 写 的 时 候 才 发 现 ， 将 整个 以 太 坊 的 知识 体系 展开 来 讲 的 
话 ， 有 很 多 的 细节 是 目 己 之 前 还 没有 掌握 的 ， 比 如 : 区 块 链 浏 览 苍 上 所 看 到 的 非 ETH 交易 记录 不 
能 作为 资产 转移 成 功 的 依据 等 。 编 写 此 书 的 过 程 中 ， 也 遇 到 了 一 些 疑 惑 点 ， 通 过 借鉴 优秀 的 博客 文 
革 、 阅 读 源码 和 咨询 业界 一 些 技术 大 佬 的 意见 ， 反 复 检 查 、 检 验 整 理 编写 入 书 内 ， 对 我 目 己 来 说 也 
是 一 种 提升 , 丰富 并 拓展 了 我 的 以 太 坊 知识 体系 。 我 在 这 里 衷心 感谢 他 们 并 将 会 在 书后 列举 出 这 些 
文革 的 链接 和 相关 大 佬 的 名 子 。 

全 书 的 内 容 关 联 性 很 串 ， 篇 幅 适 中 ， 非 必要 的 理论 性 内 容 几乎 没有 谈 及 。 在 术语 曾 述 上 ， 我 
尽力 做 到 用 通俗 的 语言 去 讲解 , 如 果 读 者 在 阅读 的 过 程 中 依然 无 法 理解 未 一 个 知识 点 ， 欢 迎 通 过 我 
的 联系 方式 直接 询问 ， 我 会 为 你 们 一 一 解答 。 

虽然 ， 笔 者 已 尽 最 大 努力 避免 书 中 内 容 出 现 错误 ， 但 由 于 水 平 所 限 ， 难 免 会 有 销 误 ， 如 果 读 
者 在 书 中 发 现 错误 的 结论 ， 欢 迎 联 系 我 进行 勘误 。 我 将 十 分 感谢 您 ! 对 于 被 纠正 的 内 容 ， 我 将 会 在 
技术 博客 中 公布 。 此 外 ， 技 术 交 流 方面 可 以 加 入 QQ 和 群 ， 群 号 等 联系 信息 参见 本 书 的 后 记 。 
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区 块 链 基础 知识 准备 


本 章 我 们 将 首先 从 区 块 链 的 基本 概念 入 手 ， 逐 步 介 绍 共识 机 制 、 共 识 算 法 、 链 的 分 又 等 概念 ， 
以 帮助 读者 建立 有 关 区 块 链 的 知识 体系 ， 为 后 续 的 开发 工作 做 好 准备 。 


1.1 iH pO B 


1.1.4. 区 块 链 的 概念 


我 们 一 般 意 识 形态 中 的 链 是 铁 链 ， 由 铁 铸 成 ， 一 环 扣 一 环 。 区 块 链 也 可 以 这 么 理解 ， 
它 不 是 由 铁 铸 成 ， 而 是 由 拥有 一 定数 据 结构 的 块 连接 而 成 ， 呈 链 状 结构 ， MEME 
区 块 抽象 到 计算 机 语言 中 就 是 一 个 对 象 、 一 个 结构 体 、 一 个 类 ， 同 样 类 中 也 可 以 定义 属性 、 
变量 和 方法 ， 但 区 块 里 包括 的 内 容 可 以 目 己 来 定义 。 比 如 ， 以 太 坊 公 链 的 区 块 结构 ， 它 有 变量 ， 我 
们 就 可 以 目 己 进行 定义 。 以 下 是 我 们 设置 一 个 区 块 包括 变量 的 例子 。 
type Block struct { 
Number string // 区 块 号 
PreHash string // 前 一 个 区 块 的 哈 希 值 
Hash string // 自身 的 哈 希 值 
Value string // 携带 的 数据 
Create int64  // 创建 的 时 间 惟 
} 
FIRK type Block struct 表示 定义 一 个 区 块 ， 其 中 定义 了 变量 Number、PreHash、Hash、Value、 
Create。 
当 链 表 中 的 每 个 数据 个 体 是 上 述 区 块 的 时 候 就 构成 了 一 条 区 块 链 。 区 块 是 区 块 链 每 一 环 的 实 
体 。 这 是 一 种 最 简单 的 区 块 链 。 如 图 1-1 所 示 ， 其 中 篆 头 的 方 占 代表 的 是 子 块 关联 父 块 ， 也 可 以 将 
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箭头 反 过 来 ， 表 示 父 块 连接 子 块 。 


1-1 正常 形态 的 链 


由 于 链 中 的 区 块 包含 数据 , 例如 上 面 的 Value 变量 , 因此 我 们 能 够 在 这 个 区 块 被 打包 到 链 中 的 
IIR] Value 填充 值 ， 此 后 我 们 通过 访问 这 个 区 块 内 部 的 数据 可 对 它 打 包 的 数据 进行 读 取 , 然后 输 
di, HH. 

在 上 面 的 例子 中 ， 我 们 用 来 存储 打包 到 区 块 中 的 数据 变量 只 有 一 个 Value， 那 么 请 想象 一 下 ， 
如 果 把 Value 换 成 一 个 数组 或 者 更 多 变量 , 这 个 区 块 就 会 变 得 更 复杂 , 它 的 功能 也 会 跟着 变 得 更 多 。 

此 外 ， 链 中 的 区 块 被 规定 是 唯一 的 ， 即 相同 区 块 号 的 区 块 不 能 以 同一 个 身份 〈 以 太 坊 中 允许 
有 区 块 号 一 样 的 不 同 含义 块 ) 在 同一 条 链 中 出 现 两 次 ， 如 果 出 现 了 ， 那 么 链 会 将 其 纠正 过 来 。 

下 面 是 网 上 对 区 块 链 的 定义 解释 : 

“区 块 链 是 分 布 式 数据 存储 、 点 对 点 传输 、 共 识 机 制 、 加 密 算法 等 计算 机 技术 的 新 型 应 用 模 

这 个 概念 其 实 是 一 个 三 义 的 解释 ， 笔 者 更 趋 回 于 把 这 个 解释 理解 为 区 块 链 节 点 程序 ， 而 不 是 
区 块 链 , 因为 一 个 区 块 链 的 节点 服务 程序 就 包含 了 这 个 概念 中 的 各 个 模块 , 实际 上 还 有 很 多 其 他 的 
模块 。 

一 般 来 说 ， 区 块 链 公 链 包含 但 不 限于 下 面 的 技术 模块 : 


(1) 数据 加 密 签 名 技术 模块 。 
(2) 共识 机 制 技 术 模块 。 

(3) 分 布 式 数据 存储 技术 模块 。 
(4) 点 对 点 通信 传输 技术 模块 。 
C5) 智能 合约 技术 模块 。 

C60 应 用 程序 接口 技术 模块 。 


当 我 们 把 这 些 模块 技术 实现 的 代码 整合 到 一 个 程序 中 时 ， 它 便 是 一 个 区 块 链 应 用 ， 例 如 不 一 
条 公 链 。 

那么 是 不 是 区 块 链 应 用 一 定 要 全 部 实现 这 些 技术 模块 呢 ? 不 是 的 ， 你 可 以 开发 目 己 的 区 块 链 
公 链 ， 哪 怕 是 超级 重音 的 锥 形 ， 只 要 是 链 状 的 区 块 存储 应 用 ,就 可 以 称 为 区 块 链 。 请 记 住 ， 任 何 一 
个 复杂 的 区 块 链 应 用 , 例如 知名 的 公 链 ， 都 是 在 简单 的 模型 上 进行 技术 的 添砖加瓦 打造 出 来 的 。 此 
外 ,区 块 链 的 各 个 技术 模块 所 包 合 的 知识 点 也 是 非常 丰富 的 ,可 以 说 每 一 个 知识 点 都 属于 一 个 领域 。 


1.4.2. DŽ 


区 块 链 的 链 分 类 通常 有 3 类 ， 即 公有 链 、 私 有 链 和 联盟 链 。 这 3 类 链 的 主要 区 别 是 : 
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CD 公有 和 链 的 维护 节 扣 比较 多 , 节点 网 络 对 所 有 人 开放 , 任何 人 都 可 以 进行 特定 的 数据 访问 。 
(2) 私有 和 链 是 面向 个 人 或 条 个 组 织 的 。 
G) 联盟 链 是 多 个 组 织 团体 的 节点 联合 在 一 起 维护 的 ， 对 组 织 开 放 。 


目前 被 广泛 接受 、 认 可 、 有 价值 的 “ 代 币 ” CToken) 几乎 都 是 基于 公有 链 的 。 
不 同 种 类 的 公有 和 链 之 间 要 实现 相互 通信 ， 比 如 比特 币 公 和 链 和 以 太 坊 公 链 进行 BTC 兑换 ETH 
的 交易 ， 需 要 借助 技术 手段 来 实现 ， 例 如 路 链 通 信 技 术 。 


1.1.3 ”区 块 链 能 做 什么 


从 区 块 链 普遍 的 去 中 心 化 的 特点 来 看 ， 在 节点 网 络 中 ， 如 果 某 条 公 链 的 合法 节点 数 日 达到 一 
定 的 数量 级 ， 那 么 我 们 可 以 认为 当前 公 链 的 去 中 心 化 程度 接近 100%， 这 意味 着 链 上 的 数据 不 会 再 
被 算 改 了 ， 于 是 我 们 所 传递 到 链 上 被 保存 在 区 块 中 的 数据 会 一 直 存 在 下 去 ， 真 实 而 永久 。 

基于 这 个 特点 ， 我 们 可 以 将 区 块 链 应 用 到 数据 的 济源 存储 方面 。 除 此 之 外 ， 还 可 以 根据 区 块 
链 具 体 提供 的 功能 进行 各 种 应 用 。 例如， 以 太 坊 公 链 ， 它 是 区 块 链 ,而 且 提 供 了 智能 合约 这 类 具备 
图 灵 完 备 的 功能 模块 ， 我们 可 以 基于 它 来 开发 智能 合约 去 中 心 化 应 用 DApp， 其 中 最 为 普遍 的 便 是 
ERC20 智能 合约 所 对 应 的 “ 代 币 ”。 

要 理解 区 块 链 能 做 什么 ， 可 以 从 实际 的 区 块 链 应 用 所 具备 的 特点 进行 思考 ， 从 而 得 出 答案 。 


1.2 ”共识 的 作用 


每 条 区 块 链 的 节点 ， 例 如 以 太 坊 节点 ， 痢 拥有 目 己 存储 数据 的 地 方 ， 节 点 之 间 虽 然 会 相互 通 
信 ， 但 又 彼此 不 依赖 ， 这 是 因为 互 不 信任 。 

在 这 种 情况 下 ， 各 个 节点 如 何 保 证 在 互相 通信 的 过 程 中 维护 数据 的 一 臻 性， 从 而 使 链 上 相同 
区 块 号 的 区 块 只 有 一 个 呢 ? 此 时 就 诞生 了 区 块 链 技术 栈 中 的 另 一 个 知识 点 : 共识 ， 又 称 共识 机 制 。 

所 谓 共识 ， 通 俗 来 讲 ， 就 是 我 们 大 家 对 茶 种 事物 的 理解 达成 一 致 的 意思 。 比 如 说 日 常 开会 讨 
论 问题 ， 又 比如 判断 一 个 动物 是 不 是 猫 ， 我 们 肉眼 看 了 后 觉得 像 猫 ， 其 符合 猫 的 特征 ， 那 么 我 们 认 
为 它 就 是 猫 。 这 就 是 共识 ， 可 见 共识 是 一 种 规则 。 

继续 上 述 会 议 的 例子 。 参 与 会 议 的 人 ， 通 过 开会 的 方式 达到 解决 问题 的 目的 。 对 比 区 块 链 中 
参与 挖 矿 的 节操 ,节点 中 有 矿工 这 么 一 种 角色 ， 它 在 代码 中 对 应 条 一 个 功能 模块 。 节点 矿工 通过 茶 
种 共识 方式 (算法 ) 来 解决 该 节点 的 账本 与 其 他 节点 的 账本 保持 一 臻 。 账 本 保持 一 致 的 意思 是 : 各 
个 节点 同步 的 区 块 的 信息 保持 一 致 ， 以 维护 同一 条 区 块 链 。 

那么 为 什么 需要 共识 呢 ? 没有 共识 可 不 可 以 ? 当然 不 可 以 ， 这 样 会 出 现 问 题 ， 假 如 生活 中 没 
有 共识 规则 ， 那 么 一 切 都 会 乱 套 。 区 块 链 与 此 类 似 ， 没 了 共识 规则 ， 各 个 节点 各 干 各 的 ， 会 失去 一 
致 性 ， 区 块 链 也 不 会 达成 统一 。 

上 述 会 议和 区 块 链 的 对 应 关系 如 下 : 


(OD 参 会 的 人 = 挖 矿 的 矿工 
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(2) 开会 = 共识 方式 (算法 ) 
(3) 讨论 解决 问题 = 让 目 己 的 账本 跟 其 他 节点 的 账本 保持 一 致 
你 可 能 会 对 上 面 的 内 容 产 生 一 些 疑 问 : 
(1) 区 块 链 节 点 和 矿工 是 什么 关系 ? 


(2) 让 节点 账本 保持 一 致 ， 账 本 的 内 容 是 什么 ? 
(3) 为 什么 需要 共识 算法 去 保持 账本 一 致 ? 


首先 ， 我 们 来 看 一 下 区 块 链 节 点 和 矿工 的 关系 。 矿 工 是 区 块 链 节点 中 的 一 个 角色 ， 从 编程 的 
角度 来 看 ， 就 是 程序 中 的 一 个 功能 模块 。 因 此 可 见 ， 矿 工 与 区 块 链 就 是 包含 与 被 包含 的 关系 。 

其 次 ， 让 节点 账本 保持 一 人 怪 ， 账 本 的 内 容 是 什么 ?账本 的 内 容 就 是 所 有 节 扣 所 维护 的 那 条 公 
链 中 的 区 块 以 及 该 区 块 的 相关 信息 。 要 保持 这 条 链 不 出 差错 ， 块 与 块 之 间 必 须 正常 相连 。 

最 后 ， 为 什么 需要 共识 算法 来 保持 账本 一 致 呢 ? 因为 区 块 会 被 节点 中 的 一 些 功能 模块 生成 ， 
在 众多 节点 且 相 同 的 时 间 流 逝 中 ，A 节点 有 可 能 诞生 一 个 区 块 1, B 节点 也 有 可 能 诞生 一 个 区 块 1， 
这 样 它们 诞生 的 区 块 写 就 发 生 重 复 了 。 在 同一 条 链 中 ， 相同 区 块 号 的 区 块 最 终 只 能 挑选 一 个 串 接 到 链 中 ， 
这 时 取 谁 的 好 呢 ? 此 时 就 再 要 用 共识 鼻 法 这 一 规则 来 做 出 选择 了。 这 个 选择 的 大 致 形式 可 参考 图 1-2。 


b 


DEO TC 
:为 胜出 块 。 随 后 上 链 


1 


ANSA -一 > 共识 算法 判断 
节点 中 国 都 生成 了 区 块 8 


节点 澳大利亚 


1-2 用 共识 算法 选 出 胜出 块 


1.3 m$ ULT) 共识 算法 


目前 在 区 块 链 中 ， 使 节点 账本 保持 一 致 的 共识 算法 常见 的 有 如 下 几 种 : 
e PoW， 代 表 者 是 比特 币 (BTC ) ， 区 块 链 1.0。 
e PoS， 代 表 者 是 以 太 坊 (ETH) ， 以 太 坊 正在 从 PoW 过 渡 到 PoS， 区 块 链 2.0。 
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e DPoS， 代 表 者 是 柚子 (EOS), Kkkt 3.0. 
e PBFT 拜占庭 容错 ， 联 盟 链 中 常用 。 


下 面 通 俗 地 介绍 前 3 种 共识 算法 的 概念 及 优 缺 点 。 


1.3.1 PoW 算法 


PoW (Proof of Work， 工 作 量 证 明 ) 的 字面 意思 是 谁 干 的 活 多 ， 谁 的 话语 权 就 大 ， 在 一 定 层面 
上 类 似 于 现实 生活 中 “多 筋 多 得 ”的 概念 。 

以 比特 币 为 例 ， 比 特 币 挖 矿 就 是 通过 计算 符合 某 一 个 比特 币 区 块头 的 哈 希 敌 列 值 争夺 记 账 权 。 
这 个 过 程 需 要 通过 大 量 的 计算 实现 ,简单 理解 就 是 挖 矿 者 进行 的 计算 量 越 大 (工作 量 大 ) ， 它 尝试 
解答 问题 的 次 数 也 就 变 得 越 多 ， 解 出 正确 答案 的 概率 目 然 越 高 ， 从 而 就 有 大 概率 获得 记 账 权 ， 即 该 
矿工 所 挖 出 的 区 块 被 串 接 入 主 链 。 


下 面 对 上 述 一 段 话 所 涉及 的 几 个 术语 做 一 下 解释 。 


(1) KIR (Header) : 区 块 链 中 区 块 的 头 部 。 比 如 你 有 一 个 饭盒 ， 饭 盒 的 第 一 层 类 似 动物 
头 部 ， 称 之 为 头 部 ; 第 一 层 放 看 米饭 ， 米 饭 就 是 头 部 装载 的 东西 。 

(2) 蛤 布 (Hash〉: 数学 中 的 敌 列 函数 (数学 公式 ) 。 

GRAAE: 通过 哈 希 函数 得 出 的 值 ,例如 ,有 加 法 公式 “1+2=3”, 那么 蛤 布 公式 hash(1,2) 
计算 出 来 的 结果 即 为 哈 希 敌 列 值 。 

(4) 区 块头 的 哈 希 散 列 值 : 饭盒 第 一 层 逆 的 是 米饭 ， 那 么 这 个 值 束 是 区 块头 逆 的 东西 。 

(55 WIRA, WERN: 在 大 家 都 参与 挖 区 块 的 情况 下 ， 谁 挖 出 的 区 块 是 有 效 的 ， 谁 就 有 记 账 
权 或 话语 权 。 

在 POW 共识 算法 下 ， 当 很 多 个 节操 都 在 挖 矿 时 ， 每 个 节点 都 有 可 能 挖 出 一 个 区 块 。 比 特 币 区 
块 链 定义 了 区 块 被 挖 出 后 , 随 之 要 被 广播 到 其 他 节点 中 去 , 然后 每 个 节点 根据 对 应 的 验证 方式 对 区 
块 进行 是 否 合法 的 验证 操作 ， 被 确认 合法 的 区 块 便 会 被 并 入 主 链 中 去 。 

对 比 现实 生活 ， 比 如 数学 竞赛 ， 参赛 者 相当 于 矿工 ， 一 道 题目 ， 谁 先 做 出 就 公布 计算 过 程 和 
答案 ， 不 由 裁判 判断 ， 由 参赛 者 来 一 起 验证 ; 大 家 都 认可 后 ， 宣 布 该 题目 结束 ， 解 题 者 及 相关 信息 
被 记录 到 纸 质 册子 或 数据 库 ， 之 后 继续 下 一 道 题 。 

回 到 比特 币 控 矿 中 ， 其 实 就 是 计算 出 正确 的 哈 硕 做 列 值 ， 一 旦 计算 出 来 ， 束 生成 新 区 块 ， 并 
将 生成 的 区 块 信息 以 广播 的 形式 告诉 其 他 节点 。 其 他 节点 收 到 广播 信息 后 ， 停 下 手 上 的 计算 工作 ， 
开始 验证 该 区 块 的 信息 。 夺 信息 有 效 ， 则 当前 最 新 区 块 被 节点 承认 ， 各 个 节 扣 开始 挖 下 一 个 区 块 ; 
若 信息 无 效 , 则 各 个 节点 继续 目 己 的 计算 工作 。 这 里 的 难题 在 于 哈 希 散 列 值 的 计算 随 关 比特 币 中 难 
度 系数 〈 一 个 能 增加 计算 难度 的 变量 数字 ) 的 增 大 会 越 来 越 内 难 ， 导 人 致 计算 需要 耗费 大 量 的 电力 资 
源 ， 工 作 量 巨大 。 

此 外 ， 成 功 挖 出 有 效 区 块 的 矿工 节点) 将 会 获得 奖励 。 在 不 同 的 区 块 链 体 系 中 ， 奖 励 的 东 
西 不 同 ， 比 特 币 区 块 链 体系 中 的 奖励 是 比特 币 。 

图 1-3 是 节 扩 使 用 Pow 共识 算法 共同 承认 胜出 块 ， 并 将 胜出 块 串 接 上 链 的 模型 图 。 
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b 


. ” 选 出 中 国 节点 的 区 块 
: ”为 胜出 块 。 随 后 上 链 
A 1 
节点 新 加 坡 
中 国 节点 和 Pow 共识 算法 
"Y 英国 节点 判断 ， 发 现 中 国 节点 的 区 块 生成 
Ds 中国 都 生成 了 区 块 8 时 间 比 英国 的 要 快 
T 节点 澳大利亚 
节点 英国 
1-3 用 PoW 共识 算法 选 出 胜出 块 
PoW 共识 算法 具有 下 面 的 优 缺 点 : 


1) 优点 

e ”机制 设计 独特 。 例 如 挖 矿 难度 系数 自动 调整 、 区 块 奖励 逐步 减 半 等 ， 这 些 因素 都 是 基于 经 济 
学 原理 的 ， 能 吸引 和 鼓励 更 多 的 节点 参与 挖 矿 。 

e 早 参 与 早 获 利 。 越 早 参 与 的 人 获得 的 越 多 。 在 初始 阶段 ， 会 促使 加 密 货 币 迅 速 发 展 ， 节 点 网 
络 迅 速 扩 大 。 

e 通过 “ 控 矿 ”的 方式 发 行 和 ， 把 代 币 分 散 给 个 人 人， 实现 了 相对 公平 。 

(2) 缺点 

e 算 力 是 计算 机 硬件 (CPU, GPU 等 ) 提供 的 ， 要 耗费 电力 ， 是 对 能 源 的 直接 消耗 ， 与 人 类 追 
求 节能 、 清 洁 、 环 保 的 理念 相悖 。 

@ PoW 机 制 发 展 到 今天 , 算 力 的 提供 已 经 不 再 是 单纯 的 CPU 了 ， 而 是 逐步 发 展 到 GPU, FPGA 
乃至 ASIC 矿 机 。 用 户 也 从 个 人 挖 厂 发 展 到 大 的 厂 池 、 厂 场 ， 算 力 集中 越 来 越 明 显 。 这 与 去 
中 心 化 的 思想 背道而驰 。 

e 按照 目前 的 挖 矿 速 度 ， 随 着 难度 越 来 越 大 ， 当 挖 矿 的 成 本 高 于 挖 矿 收益 时 ， 人 们 挖 矿 的 积极 
性 会 降低 ， 造 成 大 量 算 力 减 少 。 
基于 PoW 节点 网 络 的 安全 性 邻 人 堪忧 。 

大 于 51% 算 力 的 攻击 。 在 “PoW 共识 机 制 的 S1% 算 力 攻击 ”一 节 中 会 详细 介绍 。 


问题 解答 : 

C) 如 果 遇 到 同时 解 出 问题 的 情况 怎么 办 ? 

确实 存在 会 同时 解 出 的 情况 ， 即 使 我 们 把 区 块 生 成 时 间 的 时 间 戳 定义 到 秒 或 者 坚 秒 级 别 ， 依 
然 会 有 同时 间 挖 到 矿 的 情况 。 对 于 这 种 情况 ，PoW 共识 算法 无 能 为 力 。 具 体 的 解决 方法 会 在 “ 链 
的 分 又 ”一 节 中 谈 到 。 
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(2) 为 什么 是 51% 算 力 ， 而 不 是 50.1%? 
这 个 问题 将 会 在 “PoW 共识 机 制 的 51% 算 力 攻 击 ” 一 节 中 进行 解答 。 


1.3.2 PoS 算法 


而 是 在 创 世 区 块 内 写 明 股权 分 配 比例 ， 之 后 通过 转让 、 交 易 的 方式 ， 也 就 是 我 们 说 的 IPO CInitial 
Public Offerings) 公开 筋 股 方式 ， 逐 渐 分 散 到 用 户 钱包 地 址 中 去 ， 并 通过 “利加 ”的 方式 新 增 货 币 ， 
实现 对 节点 地 址 的 奖励 。 

Pos 的 意思 是 股份 制 。 也 就 是 说 ， 谁 的 股份 多 ， 谁 的 话语 权 就 大 ， 这 和 现实 生活 中 股份 制 公 局 
的 股东 差不多 。 但 是 ， 在 区 块 链 的 应 用 中 ， 我 们 不 可 能 真实 地 给 链 中 的 节点 分 配股 份 ， 取 而 代 之 的 
是 另外 一 些 东西 ， 例 如 代 币 ， 让 这 些 东西 来 充当 股份 ， 再 将 这 些 东西 分 配给 链 中 的 各 节点 。 下 面 我 
们 通过 示例 来 闻 述 这 个 概念 。 

例如 ， 在 虚拟 货币 的 应 用 中 ， 我 们 可 以 把 持 币 量 的 多 少 看 作 拥 有 股权 、 有 上 股份 的 多 少 ， 假 设 某 
区 块 链 公 链 使 用 了 最 基础 的 还 没 进行 变种 开发 的 Pos 共识 机 制 , 以 节点 所 拥有 的 XXX 代 币 的 数量 
来 衡量 这 个 节点 拥有 的 股份 是 多 少 。 假 设 共有 3 个 节点 ，A、B 和 C， 其 中 A 节点 拥有 10000 个 
XXX 代 币 ， 而 B、C 节点 分 别 有 1000 个 、2000 个 ， 那 么 在 这 个 区 块 链 网 络 中 A 节点 产生 的 区 块 
是 最 有 可 能 被 选中 的 ， 它 的 话语 权 是 比较 大 的 。 

再 例如 ， 假 设 某 条 非 虚拟 货币 相关 的 与 实体 业 结 合 的 公有 链 ， 汽 车 链 ， 我 们 可 以 把 每 一 位 车 
主 所 拥有 的 车 辆 数目 和 他 的 车 价值 多 少 钱 来 分 配股 份 〈 比 如 规定 一 个 公式 : 车 数 X 车 价值 = 股份 的 
多 少 ) 。 

可 见 ， 在 PoS 中 ， 股 份 只 是 一 个 衡量 话语 权 的 概念 。 我 们 可 以 在 目 己 的 Pos 应 用 中 进行 更 加 
复杂 的 实现 ， 比 如 使 用 多 个 变量 参与 到 股份 值 的 计算 中 。 

Pos 共识 算法 以 拥有 某 样 东西 的 数量 来 衡量 话语 权 的 多 少 , 只 要 节点 拥有 这 类 东西 , 哪怕 只 拥 
有 一 个 ， 也 是 有 话语 权 的 ， 即 使 这 种 话语 权 很 小 。 

在 PoS 中 ， 块 是 已 经 铸造 好 的 。PoW 有 挖 矿 的 概念 ， 而 PoS 没有 。 在 BTC 比特 币 公 链 中 ， 
可 以 挖 矿 ; 而 在 没有 使 用 Pos 共识 算法 的 公 链 节点 中 ， 就 没有 挖 矿 这 一 回 事 。 当 然 ， 如 果 将 挖 矿 
的 概念 进行 其 他 拓展 ， 则 男 当 别论 。 

Pos 共识 算法 具有 下 面 的 优 缺 点 : 

(1) 优点 

e 缩短 了 共识 达成 的 时 间 ， 链 中 共识 块 的 速度 更 快 。 

e 不 再 需要 大 量 消耗 能 源 挖 矿 ， 节 能 。 

e 人 作 关 得不偿失 。 如 果 一 名 持 有 多 于 50% 以 上 股权 的 人 (节点 ) 43, 3835 T4631 B 6, 

因为 他 是 拥有 股权 最 多 的 人 ， 作 浆 导 致 的 结果 往往 是 拥有 股权 越 多 的 人 损失 越 多 。 


(2) 缺点 


@ 攻击 成 本 低 ， 只 要 节点 有 物品 数量 ， 例 如 代 币 数量 ， 就 能 发 起 及 数据 的 区 块 攻击 。 
e 初始 的 代 币 分 配 是 通过 IPO 方式 发 行 的 ， 这 就 导致 “少数 人 ” (通常 是 开发 者 ) 获得 了 大 量 
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成 本 极 低 的 加 密 货币 ， 在 利益 面前 ， 很 难保 证 这 些 人 不 会 大 量 抛售 。 
o 拥有 代 币 数量 大 的 节点 获得 记 账 权 的 概率 会 更 大 ， 使 得 网 络 共 识 受 少数 富裕 账户 支配 ， 从 而 
失去 公正 性 。 


1.3.3 DPoS 算法 


PoW 和 Pos 虽然 都 能 在 一 定 程度 上 有 效 地 解决 记 账 行为 的 一 致 性 共识 问题 ， 也 各 有 各 的 优 缺 
点 ， 但 是 现 有 的 比特 币 PoW 机 制 纯粹 依赖 算 力 ， 导 致 专业 从 事 挖 矿 的 矿工 群体 似乎 已 和 比特 币 社 
区 完全 分 隅 ， 某 些 矿 池 的 巨大 算 力 任 然 成 为 男 一 个 中 心 ， 这 与 比特 币 的 去 中 心 化 思想 相 冲 突 。PoS 
机 制 虽然 考虑 到 了 PoW 的 不 足 ， 但 依据 IPO 的 方式 发 行 代 币 数量 ， 导 致 少 部 分 账户 代 币 量 巨 大 ， 
权力 也 很 大 ， 有 可 能 支配 记 账 权 。DPoS (Delegated Proof of Stake， 股 份 授权 证 明 机 制 ) 共识 算法 
的 出 现 就 是 为 了 解决 PoW 和 PoS 的 不 足 。 

DPoS 引入 了 “见证 者 节点 ”这 个 概念 。 见 证 者 节点 可 以 生成 区 块 。 注 意 ， 这 里 有 权限 生成 区 
块 的 是 见证 者 节点 ， 而 不 是 持 股 节点 。 

下 面 我 们 主要 以 EOS 区 块 链 为 例 介 绍 DPoS 算法 。 

FA EOS 代 币 的 节点 为 持 股 节点 ， 但 不 一 定 是 见证 者 节点 。 见 证 者 节点 由 持 股 节点 投票 选举 
产生 。DPoS 的 选举 方式 如 下 : 每 一 个 持 有 股份 的 节点 都 可 以 投票 选举 见证 者 节点 ， 得 到 总 同意 加 
数 中 的 前 N 位 候选 者 可 以 当选 为 见证 者 节点 。 这 个 N 值 需 满足 : 至 少 一 半 的 参与 投票 者 相信 N 已 
经 充分 地 去 中 心 化 (至 少 有 一 半 参 与 投票 的 持 股 节点 数 认为 ， 当 达到 了 N 位 见证 者 的 时 候 ， 这 条 
区 块 链 已 经 充分 地 去 中 心 化 了 ) ， 且 最 好 是 奇数 。 请 注意 ， 最 好 是 奇数 的 原因 会 在 分 又 一 节 中 进行 
说 明 。 

见证 者 节点 的 候选 名 单 每 个 维护 周期 更 新 一 次 ， 见 证 者 节点 们 被 选 出 之 后 ， 会 进行 随机 排列 ， 
每 个 见证 者 节点 按 顺 序 有 一 定 的 权限 时 间 生 成 区 块 , 车 见证 人 在 给 定 的 时 间 片 不 能 生成 区 块 , 区 块 
生成 权限 将 交 给 下 一 个 时 间 片 对 应 的 见证 人 。DPoS 的 这 种 设计 使 得 区 块 的 生成 更 为 快速 ， 也 更 加 
节能 。 这 里 “一 定 的 权限 时 间 ” 不 受 算法 硬性 限制 。 此 外 ， 见 证 者 节点 的 排序 是 根据 一 定 算法 随机 
进行 的 。 

DPoS 共识 算法 具有 下 面 的 优 缺 点 : 

(10 优点 

e 能 耗 更 低 。DPoS 机 制 将 节点 数量 进一步 减少 到 N 个 ， 在 保证 网 络 安全 的 前 提 下 ， 整 个 网 络 

的 能 耗 进 一 步 降低 ， 网 络 运行 成 本 最 低 。 
o 更 加 去 中 心 化 ， 选 举 的 N 值 必须 充分 体现 中 心 化 。 
e 避免 了 PoS 的 少 部 分 账户 代 币 量 巨 大 导致 权力 太 大 的 问题 ,话语 权 在 被 选举 出 的 NN 个 节点 中 。 


o 更 快 的 确认 速度 ， 由 见证 者 节点 进行 确认 ， 而 不 是 所 有 的 持 股 节点 。 
(2) 缺点 


e 投票 的 积极 性 并 不 高 。 绝 大 多 数 持 股 节点 未 参与 投票 。 因 为 投票 需要 时 间 、 精 力 等 。 
o 选举 固定 数量 的 见证 人 作为 记 账 候选 人 有 可 能 不 适合 完全 去 中 心 化 的 场景 ， 在 网 络 节点 很 少 
的 场景 ， 选 举 的 见证 人 的 代表 性 也 不 强 。 
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o 对 于 坏 节点 的 处 理 存在 诸多 困难 。 社 区 选举 不 能 及 时 有 效 地 阻止 一 些 破坏 节点 的 出 现 ， 给 节 
点 网 络 造成 安全 隐患 。 


图 1-4 所 示 是 DPoS 共识 算法 选举 的 大 致 模型 图 。 


v 
假设 此 时 N 为 3 $, 

节点 新加坡 见证 者 节点 中 国 : 
按 顺序 
DPos 选 举 每 个 时 间 片 : 
节点 中 国 并 随机 排序 后 生产 新 区 块 Y 

中 国 节点 生 

见证 者 节点 美国 成 了 8 号， 
该 轮 结束 
a PARAH 
见证 者 节点 新 加 坡 


节点 英国 


1-4 Hj DPoS 共识 算法 选 出 胜出 块 


目前 ，EOS 的 超级 节点 有 21 个 , 也 就 是 说 N=21, 但 是 拥有 EOS 代 币 能 投票 的 节点 却 有 很 多 ， 
那么 为 什么 N 这 么 小 呢 ? 原因 是 这 样 的 : 虽然 N 代表 的 是 节点 们 认同 的 一 个 能 够 代表 已 经 足够 去 
中 心 化 的 值 ， 但 是 NN 可 以 取 23， 也 可 以 取 25， 或 者 更 大 ， 这 些 数 看 起 来 都 足够 去 中 心 化 了 ， 事 实 
上 在 EOS 公 链 的 发 展 过程 中 ，N 值 渐渐 地 趋 问 于 既 要 足够 去 中 心 化 又 要 让 性 能 跟 得 上 ， 即 处 于 中 
间 值 ， 以 达到 平衡 性 能 的 同时 又 满足 去 中 心 化 。 


EOS 的 投票 事实 上 还 是 一 种 抵押 。 投 票 的 EOS 会 被 抵押 成 资源 ， 例 如 CPU 和 网 络 资源 ， 
但 是 抵押 的 EOS 也 可 以 被 换 回 来 。 把 抵押 的 资源 换 回 EOS 通常 需要 3 天 时 间 。 


1.3.4 ”共识 算法 的 编码 尝试 


本 节 尝 试 使 用 伪 代 码 来 实现 3 种 共识 算法 ， 之 所 以 使 用 伪 代 码 是 为 了 使 读者 更 容易 理解 。 

1. 实 现 PoW 共识 算法 

首先 ， 区 块 链 中 的 各 个 节点 会 互相 通信 以 广播 新 生成 的 区 块 。 这 里 既 可 以 用 “生成 ”一 词 来 
描述 ， 也 可 以 使 用 “ 控 出 ”一 词 来 描述 ， 表 达 的 意思 是 一 样 的 ， 都 是 指 区 块 的 产生 。 

此 时 ， 我 们 需要 使 用 一 个 候选 区 块 数组 来 保存 每 一 个 节点 广播 过 来 的 和 自己 当前 节点 生成 的 
区 块 对 象 ， 以 及 一 个 全 局 的 区 块 数组 来 表示 当前 公 链 的 区 块 。 区 块 数组 的 定义 如 下 : 


globleBlocks []Blocks // 公 链 区 块 数组 
candidateBlocks []Blocks // 候选 区 块 数 组 
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假设 Block 结构 体内 的 数据 类 型 如 下 所 示 : 

type Block struct { 
Timestamp string // 时 间 惟 ， 代 表 该 区 块 的 生成 时 间 
Hash string // 这 个 区 块 的 哈 希 值 
PrevHash string  // 这 个 区 块 的 上 一 个 区 块 的 哈 希 值 
NodeAddress string // 生成 这 个 区 块 的 节点 地 址 
Data string // 区 块 携 融 的 数据 

} 


然后 我 们 需要 一 个 难度 系数 的 变量 ， 例 如 difficulty， 用 来 控制 PoW 算法 的 难度 。 这 个 数 不 一 
定 越 大 就 代表 越 难 ， 只 需要 体现 出 PoW 算法 所 描述 的 工作 量 难度 即 可 。 假 设 它 是 整 型 数 ， 数 值 越 
大 ， 计 算 难 度 就 越 大 ， 那 么 此 时 difficulty 系数 会 处 于 被 随时 调节 的 状态 中 。 在 区 块 链 的 设计 中 ， 
例如 比特 币 BTC 的 难度 系数 就 有 其 动态 调 市 的 算法 。 

这 里 ， 我 们 假设 难度 系数 difficulty=1。 

有 了 难度 系数 后 ， 还 需要 一 个 专门 用 来 根据 difficulty 校 验 区 块 哈 希 值 的 函数 。 我 们 现在 需要 
假设 一 种 难度 的 验证 算法 ， 假 设 用 哈 布 值 前 绥 0 CE Ox 后 的 0) 的 个 数 来 和 difficulty 做 比较 ， 如 
果 哈 希 值 包含 这 些 前 级 0， 那 么 校 验 通过 。 请 注意 ， 这 是 一 种 很 简单 的 验证 算法 ， 且 个 数 很 有 限 ， 
而 在 比特 币 公 链 中 ， 则 要 复杂 得 多 。 

func isBlockHashMatchDifficulty (hash string, difficulty int) bool i 

prefix := strings.Repeat("0", difficulty) // 根据 难度 值 生 成 对 应 个 数 的 前 级 0 
return strings.HasPrefix(hash, prefix) // 进 行 前 级 0 个 数 的 比较 ,包含 则 返回 true 

} 


现在 假设 节点 局 动 了 一 个 子 协 程 ， 一 个 用 来 生成 区 块 的 方法 ， 并 添加 到 候选 区 块 数组 中 去 ， 
等 等 校 验 。 下 面 的 这 个 方法 (函数 ) 是 用 来 生成 新 区 块 的 : 


// oldBlock 将 会 从 globleBlocks 中 取 len-1 下 标的 区 块 
func generateBlock(oldBlock Block, data string) Block { 
var newBlock Block 
t := PRIER 
newBlock.Index = oldBlock.Index + 1 
newBlock.Timestamp - t.String() 
newBlock.Data = Data // 区 块 的 附属 数据 
newBlock.PrevHash = oldBlock.Hash // 区 块 的 父 区 块 的 哈 希 值 
for i := 0; ; i++ { // 无 跳出 表达 式 的 for 循环 ， 代 表 不 断 地 计算 合法 的 区 块 
newBlock.Nonce - hex 
newBlock.Hash = calculateHash (newBlock) 
if isBlockHashMatchDifficulty(newBlock,difficulty) í 
// 自 校 验 一 次 难度 系数 ， 进 入 到 这 个 if 里 面 ， 证 明 难 度 符合 ， 计 算出 了 答案 
candidateBlocks = append(candidateBlocks,newBlock) // 添加 到 候选 区 


break 
] 


] 
return newBlock 


假设 节点 局 动 了 一 个 子 协 程 且 在 不 断 地 计算 候选 区 块 数 组 中 区 块 的 哈 希 值 ， 所 计算 出 的 哈 希 
值 满足 难度 系数 difficulty 的 检验 。 
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Var resultBlock Block 
for block ~ candidateBlocks { 
if isBlockHashMatchDifficulty(block,difficulty ) í 


// 请 注意 ， 为 什么 这 里 又 要 校 验 一 次 ， 不 是 在 生成 的 时 候 校 验 了 一 次 吗 ? 
resultBlock = block 
break 

} 


continue 


) 

// 后 续 便 广播 胜出 区 块 ， 并 附带 信息 ， 当 前 这 个 节点 已 经 确认 了 。 

在 各 个 节点 确认 的 过 程 中 ， 如 果 达 到 了 所 规定 的 节点 数量 ， 那 么 我 们 就 判断 该 区 块 胜出 ， 最 
终 被 公 链接 纳 。 

最 后 解答 一 下 伪 代 码 中 留 下 的 疑问 为 什么 还 要 进行 一 次 校 验 才 广播 块 呢 ? 因为 难度 系数 
difficulty 是 动态 改变 的 ， 且 候选 块 数组 中 的 diffieulty 不 一 定 就 是 我 们 当前 的 节点 所 生产 的 ， 即 使 
是 当前 节点 生产 的 , 也 有 可 能 在 生成 的 时 候 难 度 系数 已 经 被 出 块 了 , 所 以 在 最 后 广播 的 时 候 还 需要 
根据 最 新 的 difficulty 难度 系数 再 做 一 次 校 验 。 

2. 实 现 PoS 共识 算法 

相对 于 PoW， 由 于 Pos 共识 算法 没有 “ 挖 矿 ”的 概念 ， 且 它 不 是 靠 计算 工作 量 来 进行 共识 的 ， 
体现 在 代码 上 也 会 是 另外 一 种 情形 。 

首先 我 们 依然 需要 定义 一 个 候选 区 块 数 组 来 保存 每 一 个 节点 广播 过 来 的 和 目 己 当前 节点 生成 
的 区 块 对 象 : 

candidateBlocks []Blocks  // 候 选区 块 数组 


每 个 区 块 结构 体 有 一 个 变量 ， 用 来 记录 生成 这 个 区 块 的 节点 地 址 。 这 个 变量 在 PoW 的 伪 代 码 
实现 中 并 没 发 挥 作用 ,但 是 在 Pos 中 却 很 重要 。 同 样 地 ， 和 上 述 PoW 一 样 ， 我 们 定义 如 下 的 区 块 
结构 体 : 

type Block struct { 

Timestamp string // 时 间 戳 ， 代 表 该 区 块 的 生成 时 间 
Hash string // 这 个 区 块 的 哈 希 值 
PrevHash | string // 这 个 区 块 的 上 一 个 区 块 的 哈 希 值 


NodeAddress string  // 生成 这 个 区 块 的 节点 地 址 
Data string // 区 块 携带 的 数据 


} 


其 中 ，NodeAddress 变量 用 来 记录 区 块 的 节点 地 址 。 
其 次 ， 需 要 有 一 个 子 协 程 ， 专 门 负 责 授 历 候 选区 块 数组 ， 并 根据 区 块 的 节点 地 址 nodeAddress 
获取 节点 所 拥有 的 代 币 数量 ， 然 后 分 配股 权 。 


stakeRecord []string // 股权 记录 数组 
for block ~ candidateBlocks { 
coinNum = getCoinBalance(block.NodeAddress) // 获取 节点 的 代 币 数量 ， 即 股权 
for i ~ coinNum ( // 币 有 多 少 ， 就 循环 添加 多 少 次 
if stakeRecord.contains(block.NodeAddress) (| // 是 否 已 经 包含 
break // 包含 了 就 不 再 重复 添加 
} 
stakeRecord = append(block.NodeAddress) // 添加 ， 循 环 次 数 越 多 ， 股 权 越 多 
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} 

} 

接 下 来 ， 从 stakeRecord 中 选 出 一 个 竞选 胜利 者 。 这 个 概率 和 上 面 的 coinNum 有 关 ，coinNum 
越 大 就 越 有 机 会 。 为 什么 呢 ? 因为 它 的 统计 方式 是 用 coinNum 作为 循环 界限 ， 然 后 对 应 添加 
coinNum 次 的 nodeAddress， 所 以 coinNum 越 大 ， 这 个 nodeAddress 就 被 添加 得 越 多 ， 后 和 面 节点 能 
被 选 上 出 块 的 概率 也 就 越 大 。 

这 里 还 要 解答 一 个 疑点 ， 为 什么 已 经 包含 了 的 就 不 再 重复 添加 ， 因 为 当前 的 候选 区 块 数 组 
candidateBlocks 中 可 能 含有 同一 个 节点 中 的 多 个 区 块 ， 而 每 一 个 节 扣 中 的 股权 只 需要 统计 一 次 ， 即 
coinNum 只 需要 循环 一 次 即 可 。 如 果 是 多 次 循环 ， 就 会 造成 不 公平 ， 因 为 会 造成 多 次 添加 。 

在 股权 被 分 配 好 后 ， 接 下 来 准备 选 出 节点 胜利 者 。 选 择 的 方式 也 是 使 用 算法 ， 在 这 个 例子 中 
我 们 依然 采取 最 简单 的 随机 数 的 形式 进行 选择 。 注 意 , 切 勿 被 这 样 的 方式 限制 了 7 思维， 这 个 选择 算 
法 是 可 以 目 定 义 的 ， 因 而 可 以 是 更 加 复杂 的 算法 。 

index := randInt() // 得 出 一 个 整 型 随机 数 

winner := stakeRecord[index] // 取出 胜利 者 节点 的 地 址 

在 最 后 的 步骤 中 ， 就 能 根据 这 个 winner 去 所 有 候选 区 块 中 选 出 节点 地 址 和 它 一 样 的 区 块 ， 这 
个 区 块 就 是 胜利 区 块 ， 将 会 被 广播 出 去 。 


var resultBlock Block 
for block ~ candidateBlocks { 


if block.NodeAddress == winner { 
resultBlock = block // 添加 
break 

] 


) 
// 广播 出 去 ， 等 一 定数 量 的 节点 同步 后 ， 就 会 被 公 链 接纳 


以 上 是 一 个 很 简单 的 Pos 算法 机 制 的 代码 实现 ， 仅 单纯 地 根据 持 币 数量 来 进行 股权 分 配 。 事 
实 上 ， 事 情 往往 是 比较 复杂 的 。 设 想 股权 的 分 配 不 仅 只 和 代 币 数量 有 关 ， 例 如 以 太 坊 设想 的 PoS 
共识 算法 的 实现 中 加 入 了 币 龄 ,情况 又 会 如 何 呢 ? 这 时 在 候选 成 功 后 ， 以 太 坊 会 扣除 币 龄 。 作 为 开 
发 者 应 当 理 解 PoS 的 精髓 一 一 其 算法 的 实现 往往 会 衡 生出 各 种 各 样 的 变种 ， 只 有 了 解 了 这 一 点 ， 
才能 在 开发 自己 的 公有 链 时 随心 而 行 。 

3. 实现 DPoS 共识 算法 


DPoS 的 伪 代 码 实现 可 以 理解 为 Pos 的 升级 版 , 之 前 例子 中 相同 的 数据 结构 体 的 定义 这 里 不 再 
重复 。 
首先 定义 好 见证 者 节点 的 结构 体 : 
type WitnessNode struct { 
name string // 名 称 
Address string // 节点 地 址 
votes int // 当前 的 票数 ， 见 证 者 是 投票 产生 的 
} 
然后 我 们 用 一 个 由 各 个 见证 者 节点 组 成 的 数组 代表 这 一 批 见 证 者 节点 ， 往 后 的 随机 排序 操作 
也 将 会 在 这 个 数组 中 进行 。 
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var WitnessList []WitnessNode // 见证 者 节点 

现在 我 们 需要 准备 一 个 专门 用 来 对 WitnessList 进行 随机 排序 的 方法 ， 这 个 方法 须 依 赖 某 种 算 
法 对 WitnessList 进行 排序 ， 具 体 算 法 可 以 目 定 义 ， 但 要 根据 不 同 的 业务 需求 而 定 。 

下 面 我 们 依然 以 一 个 最 简单 的 随机 数 排序 为 例 。 


func SortWitnessList() { 


if NeedRestVotes() ( // 判断 是 否 需要 重新 投票 
for witness ~ WitnessList { 
witness.votes = rand.Intn(100) // 进行 投票 


} 
SortByVotes () // 根据 票数 排序 
} 
上 面 NeedRestVotes() 的 作用 是 判断 是 否 需 要 重新 投票 选 出 见证 者 节点 ， 对 应 DPoS 算法 描述 


中 的 每 过 一 个 周期 就 开始 重新 排名 ， 在 这 个 阶段 还 需要 进行 节点 的 吻 除 ， 例 如 剔除 一 些 坏 节 点 。 
这 里 以 榨 查 坏 节 扣 为 例 ， 因 为 坏 节 和 点 的 检查 时 刻 在 进行 ， 所 以 我 们 可 以 用 一 个 子 协 程 (Go 语 


言 中 ， 协 程 是 一 种 轻 量 级 线程 ， 为 了 更 加 贴切 ， 下 面 的 Go 代码 中 统称 线程 为 协 程 ) 来 专门 检查 坏 


func CheckBadNode () { 
for witness ~ WitnessList { 


if isBadNode(witness) {  // 判断 是 否 为 坏 节 点 
WitnessList.remove(witness) // 是 的 话 就 移出 它 


} 


} 
同时 ， 还 要 不 断 地 检测 是 否 有 新 的 见证 者 节 扣 被 投票 选 出 ， 是 的 话 ， 就 要 添加 这 个 节点 的 信 
恩 进 入 到 见证 者 节 扣 数组 中 。 同 时 要 对 见证 者 节 扣 总 数 的 数量 进行 N 值 限制 。 


func CheckNewWitnessNode()(í 


for f 
if WitnessList.size() < N ( // 判断 是 否 超过 N 值 


newWitness := isNewNodeComing() // 检查 是 否 有 新 的 见证 者 节点 到 来 


if newWitness !- nil { 
WitnessList = append(WitnessList,newWitness) // 添加 


} 
time.sleep(50ms) // 延 时 一 段 时 间 ， 进 行 下 一 轮 的 检测 


} 


} 

最 后 我 们 使 用 出 块 函数 从 WitnessList 见证 者 列表 中 从 上 到 下 逐个 找 出 出 块 节点 ， 进 行 出 块 ， 
并 检测 当前 轮 到 的 节 扣 是 否 出 块 超时 ， 超时 就 轮 到 下 一 个 ， 以 此 类 推 对 应 DPoS 共识 算法 的 伪 代 
pun P: 


func MakeBlock() { 
SortWitnessList() // 开始 的 时 候 ， 进 行 一 次 排序 
for ( // 无 跳出 表达 式 的 for 循环 ， 代 表 内 部 不 断 地 计算 合法 的 区 块 


witness := getWitnessByIndex (WitnessList)// 从 上 到 下 获取 
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if witness == nil 1{ 
break // 所 有 见证 者 出 块 都 出 了 问题 
} 
block,timeOut := generateBlock(witness) // 传 入 该 见证 者 节点 
if timeout (  // 是 否 超时 
continue  // 超时 就 轮 到 下 一 个 


} 
// 广播 block 块 出 去 ， 然 后 结束 该 轮 ， 等 待 下 一 次 开始 
break 


) 


在 广播 块 出 去 后 ， 其 他 见证 者 接收 到 了 广播 ， 会 对 这 个 区 块 进行 签名 见证 ， 当 达到 了 茶 个 我 
们 所 设 定 的 认为 见证 已 经 足够 了 的 值 时 ， 那 么 这 个 区 块 就 被 确认 了 。 

从 上 述 伪 代码 发 现 , 传统 的 DPoS 算法 直接 应 用 的 时 候 存 在 如 下 问题 : 每 个 见证 者 节点 都 是 循 
环 着 使 用 别 的 节点 信息 去 生成 块 ， 而 不 是 使 用 自己 节点 的 信息 。 假 设 见 证 者 节点 A、B、C 在 一 轮 
的 出 块 顺序 中 ， 节 点 C 排 在 第 一 位 ， 且 在 节点 A 和 B 中 使 用 节点 C 所 生成 的 区 块 都 没有 出 差错 ， 
那么 节点 C 就 会 在 节点 A 和 B 中 都 生成 一 次 ， 由 于 时 间 惟 不 一 样 ， 导 致 该 块 的 哈 硕 不 确定 ， 但 最 
终 只 能 有 一 个 块 被 选 上 ， 这 样 就 导致 了 算 力 浪费 。 当 然 ， 也 有 可 能 不 止 节点 A 和 B， 还 可 能 有 更 
多 的 节点 都 使 用 节点 C 生成 了 区 块 ， 那 么 结果 就 是 更 多 的 认证 者 节点 生成 了 一 个 节点 的 块 ， 去 广 
播 。 

要 解决 上 述 问 题 ， 可 以 使 用 EOS 的 做 法 : EOS 通过 见证 者 节点 信息 注册 ， 使 得 每 个 节点 都 知 
道 所 有 见证 者 节点 的 信息 ， 同 时 被 注册 的 节点 都 必须 是 满足 投票 条 件 的 。 

当 每 个 见证 节点 都 有 了 所 有 见证 者 节点 的 信息 后 ， 在 每 一 次 的 最 终 块 出 现 后 ， 都 会 使 用 特定 
的 算法 对 节点 列表 进行 排序 。 如 此 ， 当 需要 出 块 的 时 候 , 节点 会 根据 区 块 链 中 最 后 一 个 区 块 的 时 间 
来 参与 到 某 些 计算 中 , 得 出 当前 应 该 出 块 的 见证 者 节点 在 列表 中 的 下 标 , 然后 判断 这 个 节点 是 不 是 
自己 。 不 是 的 话 ， 就 会 让 自己 延迟 (delay) 一 定 的 时 间 ， 然 后 重复 上 面 的 步骤 ， 这 个 延迟 的 时 间 
就 是 DPoS 中 的 出 块 超时 ， 然 后 会 目 动 轮 到 下 一 个 见证 者 节点 。 如 果 是 目 己 就 出 块 ， 出 块 后 就 广播 
出 去 ， 等 到 2/3 的 见证 者 节点 都 签名 确认 了 ， 那 么 这 个 块 就 是 最 终 有 效 的 。 所 以 ，EOS 中 的 DPoS 
并 不 是 传统 示范 代码 中 的 那样 ， 一 个 节点 循环 着 生成 含有 别 的 节点 的 信息 的 块 。 

EOS 的 要 点 是 ， 每 个 见证 者 节点 的 自身 代码 对 所 有 见证 者 节点 的 排序 是 不 一 样 的 ， 各 节点 存 
在 同时 出 块 的 可 能 ， 但 其 提供 了 2/3 见证 者 节点 都 签名 确认 这 一 环节 ， 即 谁 最 快 被 2/3 的 见证 者 节 
点 确认 ， 谁 才 是 最 终 有 效 的 ， 解 决 了 多 个 节点 同时 生成 一 个 节点 块 的 问题 。 


1.4 BERJA X 


上 一 节 我 们 介绍 了 3 种 常见 的 共识 算法 : PoW、PoS、DPoS。 虽 然 它们 都 让 区 块 链 中 的 各 个 
节点 在 一 定 程度 上 做 到 了 共识 , 但 是 也 会 产生 不 可 避免 的 问题 一 一 链 的 分 又 。 本 节 我 们 来 认识 一 下 
什么 是 链 的 分 又 。 

我 们 知道 , 区 块 链 中 的 每 一 个 区 块 在 节点 中 被 生成 后 都 会 通过 P2P 网 络 广播 到 其 他 节点 中 去 ， 
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这 些 节点 都 是 同一 类 节点 ,它们 组 成 一 类 节点 的 节点 网 络 。 例如， 比特 币 公 链 的 节点 就 是 比特 币 公 
链 的 ， 以 太 坊 就 是 以 太 坊 的 ， 而 不 能 是 比特 币 公 链 的 节点 广播 区 块 到 以 太 坊 的 节点 中 去 。 

广播 后 的 区 块 在 到 达 了 其 他 节点 后 ， 其 他 节点 要 对 该 区 块 进行 操作 ， 例 如 进行 签名 操作 。 然 
后 , 各 个 节点 在 广播 给 它 的 一 批 又 一 批 的 区 块 和 它 自 己 所 产生 的 区 块 中 做 出 抉择 , 即 选 出 一 个 获胜 
的 区 块 。 

然而 ， 共 识 算法 仍然 无 法 保证 不 出 现 确 认 冲 突 的 问题 ,例如 比特 币 中 的 PoW 共识 算法 依赖 谁 
算出 合法 哈 希 且 谁 算得 快 来 抉择 最 终 选 谁 。 事实 上 ， 即 使 我 们 产生 区 块 的 时 间 惟 精确 到 毫秒 级 ， 依 
然 会 出 现 同 时 算出 哈 希 值 的 多 个 节点 (人 至少 有 两 个 节点 ) ， 例 如 节点 A 和 节点 B 同时 算出 了 合法 
的 哈 希 值 ， 产 生 了 区 块 1， 广 播 出 去 了 。 节 点 C 也 陆续 收 到 了 节点 A 和 节点 B 的 区 块 1， 但 是 节 
A C 首先 收 到 的 是 节点 A 的 区 块 1， 此 时 虽然 节点 B 的 区 块 1 也 合法 ， 但 是 也 不 采纳 了 。 同 时 ， 
节点 D 也 收 到 了 节点 A 和 节点 B 的 区 块 1， 但 是 节点 D 先 收 到 节点 B 的 区 块 1， 为 什么 ? 因为 节 
点 D 的 网 络 路 由 距离 节点 B 的 网 络 近 , 离 节 点 A 的 网 络 远 , 那么 节点 D 就 会 先 采 纳 节 点 B 的 区 块 
1 而 不 采纳 节点 A 的 区 块 1。 此 时 ， 链 就 分 又 了 ， 如 图 1-5 所 示 。 


A 的 区 块 1 A 的 区 块 2 


B 的 区 块 1 B 的 区 块 2 


1-5 节点 广播 块 时 路 由 距离 的 影响 


我 们 把 这 个 例子 定 为 情况 四。 这 是 一 个 很 简单 的 分 叉 模 型 。 
链 的 分 又 主要 有 以 下 两 种 情况 : 


(D 便 分 又 。 一 旦 出 现 ， 最 后 的 结果 是 一 分 为 二 ， 专 业 的 说 法 是 : 旧 节 点 无 法 认可 新 节点 产 
生 的 区 块 ， 称 为 使 分 又 。 

(2) 软 分 又 。 一 旦 出 现 ， 最 后 的 结果 是 能 竹 正 的 ， 专 业 的 说 法 是 : 旧 节 点 能 够 认可 新 节点 产 
生 的 区 块 ， 称 为 软 分 又 。 
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情况 就 是 软 分 又 的 一 种 。 当 有 两 个 或 多 个 节点 同时 挖 出 了 同 区 块 号 码 的 一 个 区 块 ， 然 后 它 
们 同时 广播 信 息 出 去 ， 假 设 一 个 是 节操 A， 而 为 一 个 是 节点 B, PAERATA A 比较 近 的 节点 ， 
还 没收 到 其 他 节点 的 消息 就 先 收 到 了 节点 A 的 信息 ,并 开始 确认 节操 A 所 挖 出 的 这 个 区 块 的 信息 ， 
随后 把 节点 A 挖 出 的 这 个 区 块 加 入 目 己 所 在 的 公 链 中 ; 同 理 ， 距 离 节点 B 比较 近 的 节 扣 也 会 先 处 
理 节点 B 控 出 的 区 块 信息 ， 并 把 节点 B 挖 出 的 这 个 区 块 加 入 目 己 所 在 的 公 链 中 ， 如 图 1-6 所 示 。 


1-6 节点 网 络 
情况 也 的 链 分 义 是 各 个 节点 在 使 用 了 同样 的 共识 算法 下 导致 的 分 又 ， 如 图 1-7 所 示 。 


1-7. 链 的 分 又 


出 现 这 种 情况 ， 矿 工 是 比较 容易 自我 纠正 的 。 由 于 节点 网 络 的 整体 解 题 能 力 和 矿工 的 数量 成 
正比 ， 因 此 链 的 增长 速度 也 是 不 一 样 的 ， 在 一 段 时 间 之 后 ， 总 有 一 条 链 的 长 度 会 超过 为 一 条 。 当 矿 
工 发 现 全 网 有 一 条 更 长 的 链 时 ,他 就 会 抛弃 当前 的 链 ， 把 新 的 更 长 的 链 复 制 过 来 , 在 这 条 和 链 的 基础 
上 继续 挖 矿 。 所 有 矿工 都 这 样 操作 , 这 条 链 就 成 为 了 主 链 , 分 又 出 来 的 那个 链 便 会 被 抛弃 掉 。 但 是 ， 
并 不 是 所 有 的 分 又 都 能 被 自动 纠正 ， 这 点 请 注意 ， 有 具体 会 在 后 面 的 章节 中 进行 说 明 。 

这 种 软 分 又 的 日 我 纠正 机 制 也 是 区 块 链 的 一 个 重要 特点 ， 就 是 最 优 链 的 选择 。 注 意 ， 不 同 的 
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公 链 ， 它 们 的 最 优 链 选择 复 法 并 不 一 样 。 币 见 的 选择 机 制 有 : 


CD 最 长 链 机 制 。 整 条 区 块 链 以 最 长 链 为 主 ， 且 各 个 节点 根据 长 链 不 断 同步 ， 目 前 比特 币 公 
链 采 用 的 就 是 这 种 机 制 。 

(2) 其 他 链 选择 机 制 。 例 如 ， 以 太 坊 的 “Ghost 协议 ”机 制 ， 将 会 在 “以 太 坊 Ghost 协议 ” 
一 节 中 进行 详细 介绍 。 

现在 我 们 可 以 解答 在 “DPoS 算法 ”一 节 中 的 问题 一 一 为 什么 DPoS 共识 算法 下 的 N 必须 取 奇 
数 的 原因 : 取 奇 数 是 为 了 避免 在 DPoS 共识 算法 下 出 现 链 的 分 又 。 因 为 在 DPoS 中 ， 区 块 在 广播 后 
必须 被 见证 者 节点 签名 认证 ， 在 达到 2/3 数目 的 见证 者 节点 签名 后 就 宣布 该 块 胜出 。 在 奇数 的 情况 
下 ， 是 永远 不 可 能 出 现 对 半 的 情况 的 ， 例 如 10 个 节点 签名 了 区 块 A、 另 外 10 个 签名 了 区 块 B。 所 
以 ， 奇 数 的 见证 者 节点 数 ， 即 N， 很 好 地 避免 了 链 的 分 又 问题 。 

注意 ， 链 的 分 又 在 不 同 的 共识 算法 中 对 应 看 不 同 的 解决 策略 。 

图 1-8 所 示 为 链 分 又 后 最 长 链 自 我 纠正 机 制 的 模型 图 。 


EL 
adi he. 


1-8. 最 长 链 自 我 纠正 机 制 
软 分 又 除了 上 面 的 情况 也 之 外 ， 还 有 男 外 一 种 情况 ， 因 共识 规则 改变 ， 旧 节点 能 够 识别 新 节 
点 产生 的 区 块 ， 但 旧 的 区 块 不 能 被 新 节点 接受 ， 这 种 情况 又 分 为 下 面 的 两 种 形式 : 
e 新 节点 全 网 算 力 大 于 等 于 51%. 
e 新 节点 全 网 算 力 小 于 50%。 
这 种 软 分 又 不 一 定 能 由 节点 自我 纠正 ， 解 决 办 法 是 必须 依赖 人 力 升 级 节点 到 同一 版 本 。 


CD. 当 新 节点 的 全 网 算 力 大 于 等 于 51% 时 ， 无论 旧 节点 升级 不 升级 ， 最 长 的 链 最 终 都 是 由 全 
部 新 节点 生成 的 区 块 所 组 成 的 链 , 而 且 这 条 最 长 链 都 是 新 旧 节 点 双方 认为 合法 的 一 条 , 原因 参考 上 
面 讲解 的 最 长 链 复制 机 制 : 
e 旧 的 能 接收 新 的 ， 在 分 叉 点 之 后 的 区 块 括 杂 着 : 
> 旧 节 点 的 区 块 。 
> 新 节点 的 区 块 。 
e 新 的 不 能 接收 旧 的 ， 但 最 终 新 的 总 比 旧 的 长 。 


(2) ZEB Ex 45 191 $3 7] /]-T- 5$0% 时 ,最 终 不 能 通过 短 的 复制 长 的 达到 统一 ,结果 是 使 分 又 。 
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原因 如 下 : 


e 旧 节 点 比 新 节点 的 链 要 长 。 
e 新 的 总 是 不 能 接受 旧 的 ， 不 会 去 复制 一 条 含有 自己 不 能 接受 的 区 块 的 链 。 


1.4.0 ENX 


如 条 区 块 链 软 件 的 共识 规则 被 改变 ， 并 且 这 种 规则 改变 无 法 癌 前 兼容 ， 旧 节 氮 无 法 认可 新 节 
点 产生 的 区 块 ， 且 旧 和 点 偶偶 束 是 不 进行 软件 层面 的 升级 ， 那 么 该 分 又 将 导致 链 一 分 为 二 。 

分 又 点 后 的 链 互 不 影响 ， 节 点 在 “站 队 不 同 派别 ”后 也 不 会 再 互相 广播 区 块 信息 。 痢 节点 和 
旧 节 点 都 开始 在 不 同 的 区 块 链 上 运行 ( 挖 矿 、 交 易 、 验 证 等 )。 

举 个 简单 的 例子 ， 如 果 节 点 版 本 1.0 所 接收 的 区 块 结构 字段 是 10 个 ，1 年 后 发 布 节点 2.0 版 
本 ，2.0 兼容 1.0， 但 是 1.0 的 不 能 接受 2.0 版 本 中 多 出 的 字段 ， 即 出 现 了 硬 分 又 。 

使 分 又 的 过 程 如 下 : 


(1) 开发 者 发 布 新 的 节点 代码 ， 新 的 节点 代码 改变 了 区 块 链 的 共识 规则 且 不 被 旧 的 兼容 ， 于 
是 节点 程序 出 现 了 分 又 (Software Fork) 。 

(2) 区 块 链 网 络 部 分 节点 开始 运行 新 的 节点 代码 ， 在 新 规则 下 产生 的 交易 与 区 块 将 被 旧 节 点 
拒绝 ， 旧 节点 开始 短暂 地 断 开 与 这 些 发 送 被 目 己 拒绝 的 交易 与 区 块 新 节点 的 连接 , 于 是 整个 区 块 链 
网 络 出 现 了 分 又 (Network Fork) 。 

(3) 新 节点 的 矿工 开始 基于 新 规则 挖 矿 ， 旧 节点 的 矿工 依然 用 旧 的 规则 ， 不 同 的 矿工 算 力 导 
致 出 现 分 又 CMining Fork) 。 

最 终 ， 整 个 区 块 链 出 现 了 分 又 〈Chain Fork) 。 
实例 : 

“2017 年 8 月 1 号 ，Bitcoin Cash (BCH) 区 块 链 成 功 地 在 区 块 高 度 478559 与 主 链 分 离 。 这 
一 新 的 加 密 货 币 默 认 区 块 大 小 为 8SMB， 并 且 可 以 实现 区 块 容 量 的 动态 调整 。 由 于 旧 节 点 只 认可 小 
于 IMB 的 区 块 ， 所 以 运行 BCH 客户 疹 贡 点 产生 的 区 块 无 法 回 前 兼容 ， 将 被 旧 节 点 拒绝 ， 最 后 运 
行 不 同 客 户 端的 矿工 将 会 长 期 运行 在 两 条 不 同 的 区 块 链 上 (BTC 和 BCH) 。” 


1.4.3 ”常见 的 分 叉 情 况 


本 节 我 们 从 正常 的 区 块 的 生成 流程 开始 , 使 用 DPoS 共识 算法 模式 , 分 析 可 能 会 出 现 分 叉 的 各 
种 情况 。 

在 正常 操作 模式 下 ， 区 块 生产 者 每 3 秒 钟 轮流 生成 一 个 区 块 ( 见 图 1-9) 。 假 设 没有 节点 错过 
自己 的 轮 次 ,后 续 便 进入 到 选 出 胜出 区 块 的 步骤 。 注意 , 区 块 生产 者 在 被 调度 轮 次 之 外 的 任何 时 间 
段 出 块 都 是 无 效 的 。 
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1-9 ”正常 形态 的 链 

下 面 假定 节点 网 络 中 共有 5 个 节点 ， 分 别 是 A、B、C、Al、B1。 

1. 少 数 节 点 分 叉 

这 是 最 常见 最 简单 的 一 种 软 分 又, 是 由 不 超过 节点 总 数 1/3 的 恶意 节点 创建 或 因 区 块 确认 时 间 
差 导 致 的 分 又 现象 。 在 这 种 情况 下 ,假设 少数 节点 分 又 每 6 秒 只 能 产生 2 个 块 , 而 多 数 节 点 分 义 每 
6 秒 可 以 产生 3 个 块 ( 因 为 多 数 节 点 在 同步 速度 上 是 比 单 节 点 向 别 的 节点 确认 它 的 块 的 时 间 要 短 ) ， 
这 样 诚实 的 2/3 多 数 节 点 维护 的 链 将 永和 撑 比 分 又 的 链 更 长 。 

如 图 1-10 所 示 ， 每 个 块 中 的 字母 代表 是 哪个 节点 产生 的 。 


图 1-10 分 又 链 含 有 较 少 的 块 


2.59282» FE 1553 X. 


当 节 扩 网 络 中 部 分 节 扣 由 于 网 络 波动 或 其 他 原因 导致 目 己 与 全 网 节点 的 网 络 断 开 了 连接 ， 即 
会 出 现 网 络 分 请 化 分 又 ， 如 图 1-11 所 示 。 


节点 B1 断 线 


1-11 Node 节点 网 络 部 分 节点 掉 线 
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节点 ATUS rx BI 断 开 了 与 主 网 的 连接 ， 此 时 它们 的 块 生 产 的 部 分 代码 依然 还 在 运行 看 ， 这 
样 生成 的 块 就 只 能 归纳 到 本 地 所 维护 的 公 链 区 块 数组 中 ,节点 网 络 被 分 成 了 3 部 分 。 请 注意 , 无 论 
如 何 分 又 ， 根 据 链 选择 复 法 ， 其 中 总 会 有 一 条 最 优 链 ， 所 以 最 终 依然 只 有 一 条 主 链 。 如 图 1-12 所 
示 ， 每 个 块 中 的 字母 代表 是 哪个 节点 产生 的 。 


zn 


l-12 多 条 分 又 链 


如 果断 线 的 节点 网 络 恢复 后 ， 重 新 连接 上 了 主 网 ， 那 么 它 会 目 动 进行 最 优 链 的 复制 ， 最 终 的 
结果 也 是 只 有 一 条 最 优 链 。 

如 果 分 叉 节 点 永远 地 脱离 了 主 网 ， 结 果 就 会 造成 健 分 又 。 如 果 脱 离 出 的 节 扣 数目 不 多 ， 那 么 
这 些 脱离 的 节操 就 会 变 成 私有 亨 点 或 组 成 一 个 联盟 链 网 络 。 

3. 多 数 市 点 舞 睿 分 叉 


所 谓 舞 炊 ， 就 是 我 们 所 理解 的 作 浆 的 意思 。 节 点 作 炊 是 指 节 点 不 遵循 共识 规则 或 做 了 一 些 非 
法 操作 ,例如 莹 试 修改 块 。 这 种 情况 下 所 导致 的 链 分 又 称 为 舞 整 分 又 。 这 类 分 又 和 网 络 分 片 化 的 模 
型 图 很 类 似 ， 不 同 点 在 于 ， 舞 次 是 节点 们 都 还 在 同一 个 主 网 中 产生 的 。 

因此 ， 舞 六 导致 的 分 叉 不 会 太 久 ， 最 终 还 是 会 被 诚实 节点 的 最 优 链 纠正 过 来 。 假 设 节 点 AT 和 
节点 Bl 是 舞 闵 者 ，A、B、C 是 遵守 规则 的 节点 ， 其 模型 图 如 图 1-13 所 示 。 


1-13 ”节点 模型 图 


以 上 是 目前 常见 的 链 分 又 情况 。 实 际 中 还 有 很 多 其 他 复杂 的 情况 ， 但 是 无 论 何 种 情形 ， 只 
不 是 价 分 又 ， 最 终 部 是 可 以 被 纠正 的 。 纠 正 的 主要 手段 有 以 下 两 种 : 

d) 最 优 链 复制 同步 。 

(2) 人 工 通 过 技术 手段 纠正 。 


1.4.4 POW 共识 机 制 的 51% 算 力 攻 击 


51% 算 力 攻击 目前 仅 在 “PoW ”共识 机 制 中 存在 ， 因 为 “PoW” 共 识 机 制 依赖 算 力 计算 获胜 ， 
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也 就 是 谁 算得 快 ， 谁 的 胜率 就 高 。 在 使 用 了 “PoW ”共识 机 制 的 区 块 链 网 络 中 ,我 们 称 参与 计算 哈 
希 的 所 有 计算 机 资源 为 算 力 ， 那 么 全 网 络 的 算 力 就 是 100%， 当 超过 51% 的 算 力 掌握 在 同一 阵营 中 
时 ， 这 个 阵营 的 计算 哈 希 胜出 的 概率 将 会 大 幅 提 高 。 

为 什么 是 51%? 50.1% 不 行 吗 ? 当然 也 是 可 以 的 , 之 所 以 取 51% 是 为 了 取 一 个 最 接近 5096, H. 
E 50% 大 的 整数 百分比 , 这 样 当 算 力 值 达 到 51% 后 的 效果 将 会 比 50.1% 的 计算 效果 更 明显 。 举 个 例 
子 ， 如 果 诚 实 节 点 的 算 力 值 是 50.1%， 那 么 坏 节 点 的 算 力 值 就 是 49.9%。 两 者 的 差距 不 算 太 大 ， 这 
样 容易 导致 最 终 的 区 块 竞争 你 来 我 往 、 长 期 不 分 上 下 。 

如 果 算 力 资源 分 散 ， 不 是 高 度 集中 的 ， 那 么 整个 区 块 链 网 络 是 可 信 的 。 然 而 ， 当 算 力 资源 集 
中 于 某 一 阵营 的 时 候 ， 算 力 的 拥有 者 就 能 使 用 算 力 资源 去 逆转 区 块 ， 导 致 区 块 链 分 叉 严 重 ， 如 下 面 
的 例子 。 

假设 图 1-14 是 一 条 区 块 链 目前 的 状态 。 一 个 攻击 者 想 要 逆转 区 块 8 中 的 一 笔 交 易 ， 他 就 会 从 
区 块 7 后 面 引 入 一 个 分 叉 来 使 区 块 8 变 得 无 效 ， 在 分 叉 块 中 设置 给 茶 个 地 址 几 百 或 者 几 千 个 BTC。 
不 过 ， 由 于 比特 币 公 链 的 最 长 链 规则 的 限制 , 所 有 的 诚实 节点 都 会 遵循 最 长 链 规则 ,将 新 产生 出 来 
的 区 块 链接 在 最 长 链 的 尾部 ， 从 而 避免 攻击 者 得 进 。 


攻击 者 想 要 逆转 区 块 8 中 的 一 个 交易 ， 他 就 会 想 要 从 
区 块 7 后 面 引 入 一 个 分 叉 来 使 区 块 8 变 得 无 效 


1-14 某 条 区 块 链 的 状态 


当 系 统 出 块 率 比 较 低 且 块 大 小 较 小 时 ， 网 络 延 迟 相对 于 出 块 时 间 来 讲 是 比较 小 的 ， 这 样 减 实 
的 节点 所 产生 的 区 块 基本 上 就 是 顺序 的 。 只 要 诚实 节 点 的 总 算 力 超过 50%， 攻 击 者 就 不 能 够 使 它 
们 目 己 产生 的 链 成 为 最 长 链 。 然而 ， 当 诚实 节 扣 的 总 算 力 不 及 坏 节 点 的 算 力 时 ， 即 坏 节 点 算 力 总 和 
超过 了 51%， 最 长 链 机 制 将 会 被 坏 节 点 利用 ， 因 为 此 时 坏 节 点 的 出 块 速度 整体 比 诚 实 节 点 快 ， 获 
胜率 高 ， 这 样 坏 节点 产生 的 区 块 将 会 形成 最 长 链 。 

此 外 ， 如 果 出 块 率 很 高 ， 会 使 得 区 块 产生 的 时 间 和 区 块 在 网 络 上 传播 的 延迟 相对 变 得 较 小 ， 
这 样 一 个 新 块 在 产生 以 后 还 来 不 及 传播 到 全 网 就 会 有 其 他 的 节点 产生 别 的 新 块 , 互相 竞争 剧烈 ， 导 
致 链 上 分 又 情况 严重 。 虽然 最 终 只 会 有 一 条 最 长 链 , 但 是 出 块 率 越 高 ， 块 大 小 越 大 , 分 又 的 情况 就 
会 越 严 重 ， 最 终 区 块 链 就 会 发 展 成 有 很 多 分 又 的 样子 ， 如 图 1-15 所 示 。 
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分 叉 块 
图 1-15 复杂 的 分 又 情况 

基于 比特 币 公 链 来 看 (以 太 坊 公 链 中 分 又 块 有 其 他 处 理 ) ， 大 量 的 分 又 会 带 来 两 个 问题 : 

CD 浪费 了 网 络 资源 和 计算 资源 ， 大 部 分 分 义 块 无 效 ， 因 为 只 有 最 优 链 中 的 区 块 才 被 认为 是 
有 效 的 。 

(2) 危害 了 安全 性 ， 整 个 区 块 链 里 的 最 优 链 变 短 了 ， 算 力 分 散在 不 同 的 分 叉 链 中 ， 这 使 得 攻 
击 者 只 需要 少 于 51% 的 算 力 就 可 以 产生 出 恶意 的 最 优 链 。 就 好 比 有 3 个 阵营 ，A 阵营 有 30% 算 力 ， 
B 阵营 有 32% 算 力 ，C 阵营 有 38% 算 力 ， 算 力 以 3 大 阵营 分 散在 A、B、C E, WRA, B. C 
自 搞 分 又 ， 那 么 最 终 C 就 可 以 以 低 于 51% 的 算 力 (38% 的 算 力 ) 达到 制造 恶意 最 优 链 的 目的 。 


1.5 小 结 


本 章 主 要 介绍 了 区 块 链 的 经 典 知 识 点 ， 包 含 区 块 链 的 定义 、 链 的 分 类 、 共 识 算法 与 伪 代 码 的 
实现 。 看 重 讲 解 了 链 分 又 的 定义 和 分 又 的 两 种 类 型 ， 价 分 又 与 软 分 又 的 定义 及 其 产生 的 原因 ， 并 讲 
解 了 常见 的 3 种 软 分 又 。 最 后 结合 “PoW ”共识 机 制 介绍 了 区 块 链 中 闭 名 的 51% 算 力 攻 击 。 


以 太 坊 基础 知识 准备 


在 上 一 半 中 ， 我 们 介绍 了 区 块 链 的 基础 知识 ， 本 章 将 开始 介绍 以 太 坊 DApp 开发 十 分 重要 的 
预备 知识 。 如 果 你 想 基 于 以 太 坊 开发 应 用 ， 请 务必 尚 握 本 章 内 容 。 


2.1 什么 是 以 大 坊 


以 太 坊 其 实 就 是 区 块 链 的 一 种 应 用 ， 是 一 条 公 链 ， 包 含 但 不 限于 “区 块 链 ”所 具有 的 技术 特点 。 
区 块 链 是 一 个 整体 的 名 词 ， 我 们 可 以 根据 区 块 链 技 术 开 友 出 很 多 公 链 或 者 私 链 ， 再 给 这 些 链 
一 个 名 称 ， 例 如 使 用 “以 太 坊 ”这 个 名 称 。 区 块 链 和 以 太 坊 的 关系 如 图 2-1 所 示 。 
比特 币 公 链 
比特 币 私 链 
区 块 链 以 太 坊 公 链 
EOS 公 链 


等 等 .. 


图 2-1 链 的 分 类 


公 链 就 是 最 多 节点 所 共同 维护 的 链 ; 私 链 是 节点 比较 少 的 链 ， 一 般 是 一 个 节点 ， 任 何人 都 可 
以 在 日 己 的 电脑 上 进行 私 链 的 部 章 , 只 需要 下 载 一 份 公 链 的 代码 ,在 日 己 的 本 地 机 右上 跑 起 来 即 可 。 

目前 行业 内 将 区 块 链 应 用 以 版 本 的 形式 进行 了 划分 ， 每 个 版 本 有 其 对 应 的 代表 性 应 用 ， 其 中 
以 太 坊 公 链 被 公认 代表 了 区 块 链 的 2.0 版 本 ， 具 体 如 下 : 
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(1) 区 块 链 1.0， 代 表 者 是 比特 币 公 链 ， 不 具备 智能 合约 功能 ， 有 具备 区 块 链 的 其 他 技术 模块 ， 
是 第 一 条 文 持 电子 货币 转账 的 完整 区 块 链 公 链 。 

(2) 区 块 链 2.0， 代 表 者 是 以 太 坊 公 链 ， 技 术 模 块 方面 比比 特 币 公 链 多 出 智能 合约 等 创新 的 
功能 ， 其 共识 机 制 正在 从 “PoW” 癌 “PoS” 过 渡 ， 但 是 直到 现在 ， 以 太 坊 最 新 版 本 的 共识 机 制 使 
用 的 依然 是 “PoW”， 虽 然 和 比特 币 一 样 是 “PoW”，, 但 是 以 太 坊 的 性 能 要 比比 特 币 公 链 高 ， 最 主 
要 的 原因 就 在 于 “PoW” 算 法 的 改进 以 及 最 优 链 的 判断 方法 不 同 。 

(3) 区 块 链 3.0， 主 要 目标 是 实现 高 性 能 、 大 吞吐 量 ， 代 表 者 是 “EOS” 柚 子 公 链 ， 有 具备 智能 
合约 功能 ， 共 识 算 法 是 “DPoS”， 现在 正在 癌 “BFT-DPoS” 方 同 发 展 。 


此 外 ， 还 有 一 些 区 块 链 框架 应 用 ， 它 们 不 是 公 和 链 。 例 如 ，IBM 公司 的 “HyperLedger” 开 源 项 
目 就 是 一 个 具备 技术 模块 插件 化 功能 的 区 块 链 框 架 ， 可 以 使 用 它 来 自 定义 开发 公 链 或 联盟 链 应 用 。 


2.2 ”以 太 坊 的 架构 


整个 以 太 坊 的 技术 栈 可 分 为 应 用 层 、 网 络 层 、 合 约 层 、 共 识 层 、 激 励 层 和 数据 层 ， 共 6 层 ， 
如 图 2-2 所 示 。 


以 太 坊 的 层级 结构 


2-2 ”以 太 坊 层级 结构 
每 一 个 层级 对 应 不 同 的 功能 。 
e 应 用 层 : 主要 是 基于 以 太 坊 公 链 衍生 出 的 应 用 ， 例 如 各 种 DApp 应 用 、Geth 控制 台 、Web3.js 
接口 库 以 及 Remix 合约 编写 软件 和 Mist 钱包 软件 等 。 
e 网 络 层 : 主要 是 以 太 坊 的 点 对 点 通信 和 “RPC” 接 口服 务 。 
e 合约 层 : 某 些 公 链 不 具备 这 一 层 ， 例 如 比特 币 就 没有 合约 层 ， 以 太 坊 的 合约 层 主要 是 基于 智 
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能 合约 虚拟 机 “EVM” 的 智能 合约 模块 . 
共识 层 : 主要 是 刷 点 使 用 的 共识 机 制 。 
激励 层 : 主要 体现 在 节点 的 挖 矿 奖励 。 挖 出 胜出 区 块 的 节点 或 打包 了 叔 块 的 区 块 所 对 应 的 节 
点 ， 矿 工会 获得 规则 所 设 定 的 ETH 奖励 。 

e 数据 层 : 用 于 整体 的 数据 管理 ， 包 含 但 不 限于 区 块 数据 、 交 易 数 据 、 事 件数 据 以 及 “levelDB” 
存储 技术 模块 等 。 

以 太 坊 的 技术 细 分 架构 如 图 2-3 所 示 ， 从 上 到 下 ， 越 底部 代表 越 底层 。 


DApp, Remix, Mist, Truffle 等 应 用 


ji Web3.js, SDK ..... 


JSON-RPC 接口 / Console 控制 台 


| asx e| 区 块 相关 (getBlockByHash, getTransactionByHash...) 


区 块 链 管 理 算法 挖 矿 网 络 


Pow j || (Worker] | |[ Pee ) 


Cima [CE 
mms R) 


图 2.3 以太 坊 技术 架构 图 


应 用 通过 Web3.js 或 其 他 版 本 的 以 太 坊 接口 访问 代码 ， 来 访问 以 太 坊 的 “RPC” 接 口 获取 对 应 
的 数据 。 接 口 分 为 与 智能 合约 相关 和 与 区 块 相 关 ， 共 两 个 部 分 。 

Whisper 是 P2P 通信 模块 中 的 协议 ,节点 间 的 点 对 点 通信 消息 都 经 过 它 转发 ,所 转发 的 消息 都 
经 过 加 密 传输 ， 如 图 2-4 所 示 。 


P2P 


Whisper 
Peer 节点 协议 


2-4 Whisper 协议 


Swarm 是 以 太 坊 实现 的 类 似 于 IPFS 的 分 布 式 文件 存储 系统 , 在 P2P 模块 中 结合 Whisper 协议 
使 用 。 

HttpClient 是 HTTP 服务 请 求 方法 的 实现 模块 。 

Crypto 是 以 太 坊 的 加 密 模块 ， 内 部 包含 sha3 、secp256kl 等 加 密 算 法 。 
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RLP 是 以 太 坊 所 使 用 的 一 种 数据 编码 方式 ， 包 含 数 据 的 序列 化 与 反 序 列 化 。 关 于 数据 编码 方 
式 ， 除 我 们 常见 的 方式 之 外 ， 还 有 base16、base32 和 base64 等 。 

Solidity 是 以 太 坊 智能 合约 的 计算 机 编程 语言 ， 由 它 编写 智能 合约 ， 使 用 时 由 EVM 虚拟 机 载 
AFHZ. 

LevelDB 是 以 太 坊 所 使 用 的 键 值 对 数据 库 。 区 块 与 交易 的 数据 都 采用 该 数据 库存 储 。 此 外 ， 
在 以 太 坊 中 ， 作 为 键 Key) 的 一 般 是 数据 的 “Hash” 值 ， 而 值 (Value) 则 是 数据 的 “RLP” 编 码 。 

Logger 是 以 太 坊 的 日 志 模 块 ， 主 要 包含 两 类 日 志 : 一 类 是 智能 合约 中 的 事件 (Event) His; 
该 类 日 志 被 存储 到 区 块 链 中 ， 可 以 通过 调用 相关 的 “RPC” 接 口 获取 ; 另 一 类 是 代码 级 别 的 运行 日 
志 ， 这 类 日 志 会 被 保存 为 本 地 的 日 志文 件 。 
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2.3.1 DApp 概述 


DApp 的 英文 全 称 是 “Decentralized Application”， 对 应 的 中 文 解释 是 : 去 中 心 化 应 用 ， 又 称 
分 布 式 应 用 。 

关于 分 布 式 应 用 可 分 为 传统 的 DApp 和 区 块 链 DApp, 下 面 我 们 看 一 下 这 类 分 布 式 应 用 的 不 同 。 

1. 传统 的 分 布 式 应 用 

在 区 块 链 出 现 之 前 ，DApp 已 经 存在 了 ， 我 们 可 把 这 种 DApp 称 为 传统 的 分 布 式 应 用 。 我 们 以 
所 熟悉 的 C/S 〈ClientServer， 客 户 端 / 服 务 器 端 ， 亦 称 为 客户 机 /服务 器 ) 结构 来 看 一 下 这 种 分 布 式 
应 用 的 特点 。 我 们 知道 ， 一 个 Server 是 可 以 服务 于 多 个 Client 的 ， 如 果 不 考 虑 各 个 Server 之 间 的 
通信 ， 那 么 这 种 一 对 多 的 形式 可 看 作 如 图 2-5 所 示 的 简单 交互 形式 。 


发 送 请 求 与 
Client 1 接收 数据 返回 


2-5 客户 端 和 服务 器 端 交 互 的 示意 
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在 这 种 C/S 结构 中 ， 相 同 功能 的 Server 允许 有 多 个 ， 它 们 可 以 被 放置 在 不 同 的 地 方 ， 如 果 多 
个 Server 之 间 可 以 相互 通信 ， 我 们 就 称 Server 部 分 为 分 布 式 集群 ， 如 图 2-5 所 示 。 


SESS 
Hu 
Server 美国 
/lIN = 
HE Server 新 加 坡 
。 = | Server 
HE Server 中 国 分 布 式 集群 
N mA Server 悉尼 
。 = 
Server 深圳 


2-6 分布 式 集群 的 大 概 模型 


图 2-6 这 种 Server 分 布 式 集群 只 是 一 个 大 概 的 模型 ， 事 实 上 还 会 有 其 他 中 间 件 罕 揪 其 间 ， 如 
图 2-7 所 示 。 在 这 类 传统 的 分 布 式 应 用 中 ,往往 是 多 个 Server 与 同一 个 数据 源 交 互 ， 即 多 个 Server 
进行 数据 的 读 写 操 作 。 注 意 ， 这 是 一 个 重要 的 差异 ， 即 传统 的 分 布 式 应 用 DApp， 它 的 数据 存储 源 
总 是 相同 的 ， 即 使 数据 源 做 了 分 布 式 集群 ， 也 依然 不 是 去 中 心 化 的 ， 同时， 系统 管理 员 也 可 以 访问 


虚线 ， 代 表 Server NH. 4 


SUO P i$ s Ww 
. 2,49" * 
...°8? 


Client 2 HEE a * - 
。 = 


; eo : Y 4 
Server 美国 ^ : y 


E: Server 
"4 i Server 新 加 坡 


Server 悉尼 


Server 英国 


2-7 中间 件 穿插 其 间 的 分 布 式 集群 
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2. 区 块 链 去 中 心 化 分 布 式 应 用 


区 块 链 去 中 心 化 分 布 式 应 用 DApp 与 传统 的 分 布 式 应 用 DApp 的 最 大 不 同 点 在 于 ,前 者 是 完全 
去 中 心 化 的 ， 特 别 是 数据 存储 部 分 。 在 区 块 链 这 种 分 布 式 应 用 中 ，Server 被 重新 命名 为 节点 ， 名 称 
HET, 但 其 本 质 没 变 ,依然 是 为 Client 提供 服务 的 ， 只 是 每 个 节点 由 不 同 的 组 织 党 理 ， 并 对 应 有 
目 己 的 数据 存储 区 域 。 

去 中 心 化 DApp 每 个 节点 都 有 目 己 的 数据 存储 地 ， 而 且 节 点 之 间 可 以 彼此 相互 通信 却 又 不 依 
赖 其 他 节点 (因为 互 不 信任 〉， 例 如 A 节点 无 法 直接 访问 B 市 点 的 数据 库 。 在 这 种 互 不 信任 的 体 
RP, 各 个 节点 通过 共同 遵循 共识 算法 来 达到 数据 同步 的 目的 , 同时 各 个 节点 之 间 又 维护 了 一 条 区 
块 链 。 它 们 的 交互 形式 大 致 如 图 2-8 Pr 


v.. 


向 节点 发 送 请 求 与 A Tei 
接收 数据 返回 pape 
PEEBEREEREENNPN Be y 
节点 中 国 同 维护 一 
Clients N 条 区 块 链 
arr 节点 澳 大 利 
节点 英国 


2-8 区 块 链 节点 去 中 心 化 集群 
本 书 所 要 阐述 的 DA pp 就 是 这 种 区 块 链 去 中 心 化 分 布 式 应 用 。 


2.3.2 ”以 太 坊 上 的 DApp 


以 太 坊 拥有 图 灵 完 备 的 智能 合约 模块 ， 使 得 开发 者 可 以 先 编写 好 智能 合约 代码 ， 再 到 它 上 面 
部 蜀 智 能 合约 ， 最 终 变 为 合约 应 用 ， 也 就 是 DApp。 

智能 合约 被 部 蜀 到 链 上 后 是 能 够 被 访问 的 。 为 了 完善 DApp 的 功能 ， 开 发 者 可 以 采用 计算 机 
语言 (例如 Java 或 者 Go) 来 编写 对 应 于 当前 所 发 布 的 智能 合约 的 访问 接口 ， 用 户 通过 访问 接口 访 
问 链 上 的 合约 ， 得 到 输出 的 数据 。 

这 其 实 也 就 是 当前 基于 以 太 坊 所 开发 的 DApp 的 工作 流程 。 一 个 DApp 中 包含 多 个 角色 , 每 个 
角色 都 有 其 各 自 的 功能 ， 具 体 说 明 如 下 : 

e 智能 合约 应 用 ， 布 置 在 链 上 ， 负 责 链 上 数据 的 处 理 。 

e 中 继 服 务 器 ， 布 置 在 开发 者 的 物理 服务 器 上 ， 负 责 接 收 用 户 的 请 求 和 访问 链 上 的 智能 合约 应 

用 ， 再 将 数据 结果 返回 给 用 户 。 
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e 以太 坊 公 链 ， 是 智能 合约 的 集成 运行 环境 以 及 实现 去 中 心 化 等 区 块 链 功 能 的 核心 支撑 。 
图 2-9 是 目前 以 太 坊 DApp 的 常见 交互 模型 图 。 


mm. (0)—13 


中 继 服务 器 i 
提供 接口 智能 合约 DAPP MAHERE 


2-9 以 太 坊 DApp 的 交互 模型 图 


2.4 区 块 的 组 成 


本 节 我 们 主要 介绍 以 太 坊 公 链 区 块 〈Block) 的 定义 与 组 成 。 


2.4.4 区 块 的 定义 


在 共识 算法 的 伪 代 码 中 ， 我 们 已 对 区 块 做 过 介绍 ， 区 块 其 实 就 是 一 种 数据 结构 ， 内 含 变量 和 
属性 ， 这 些 变 量 和 属性 可 由 开发 人 员 目 行 定义 。 在 以 太 坊 的 1.8.11-Golang 版 本 代码 中 ， 给 出 了 如 
下 的 区 块 定 义 : 


type Block struct 1{ 


header *Header 

uncles []*Header // 这 个 是 保存 叔 块 头 部 信息 的 数组 变量 
transactions Transactions 

// BF 


hash atomic.Value 
size atomic.Value 


// Td 是 核心 模块 core 用 来 存储 当前 区 块 被 挖 出 后 ， 区 块 的 总 难度 
td *big.Int 


ReceivedAt  time.Time // 区 块 被 接收 的 时 间 
ReceivedFrom interface{} // 记录 该 区 块 是 从 哪个 P2P 网 络 传 过 来 的 
} 
从 上 述 区 块 的 定义 可 以 看 到 ， 有 很 多 变量 ， 现 在 我 们 不 需要 了 解 所 有 这 些 变 量 ， 除 非 你 要 深 
入 分 析 以 太 坊 的 源码 ， 但 这 也 会 花 掉 你 大 量 的 时 间 和 精力 ， 建 议 读 者 等 使 用 以 太 坊 做 了 一 定 的 
DApp 开发 之 后 再 进行 源码 的 全 面 分析 。 
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有 关上 面 的 区 块 结构 ， 建 议 重 点 了 解 以 下 部 分 : 


Header， 区 块 的 头 部 结构 体 。 

Transactions， 当 前 该 区 块 所 有 打包 的 交易 记录 的 结构 体 数 组 。 

Hash， 区 块 的 哈 希 值 ， 这 个 值 的 计算 是 比较 复杂 的 ， 是 将 当前 的 区 块头 (Header 内 的 数据 ) 
整体 地 进行 哈 希 算法 运算 之 后 所 得 出 的 哈 希 值 ， 一 旦 区 块头 中 某 一 个 成 员 变 量 的 数据 值 改变 
了 ， 该 哈 希 值 就 会 随 之 改变 。 

Uncles， 叔 块 ， 拥 有 特别 的 含义 ， 将 会 在 下 面 的 “ 叔 块 ”一 节 中 进行 详细 介绍 。 


下 面 我 们 再 来 看 一 下 最 主要 的 区 块 Header 结构 体 的 组 成 部 分 。 


type Header struct { 


} 


ParentHash  _ common .Hash 
UncleHash common.Hash 


Coinbase common.Address 
Root common.Hash 
TxHash common.Hash 
ReceiptHash common.Hash 
Bloom Bloom 
DafticulEy "Dig. INE 
Number *big.Int 
GasLimit uint64 
GasUsed uint64 

Time *brq.Int 
Extra []byte 
MixDigest | common.Hash 
Nonce BlockNonce 
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的 知识 逐一 解析 。 


ParentHash: 这 是 当前 区 块 的 上 一 个 区 块 的 哈 布 值 。 请 回忆 一 下 区 块 的 链 状 结构 ， 也 正 是 因 
为 有 这 个 变量 的 存在 ， 后 一 个 区 块 的 数据 里 面 才 有 了 上 一 个 区 块 的 哈 布 值 ， 从 而 在 上 下 连接 
的 层次 上 ， 体 现 出 区 块 链 的 特点 。 

Coinbase: 当 节 点 首次 启动 时 默认 配给 当前 节点 的 一 个 钱包 地 址 ， 以 太 坊 节点 使 用 POW 共识 
算法 挖 矿产 生 的 ETH 代 币 奖励 会 被 打 入 该 地 址 。 如 果 想 使 挖 矿 奖 励 进入 其 他 账户 , 可 以 进行 
设置 。 另 外 ， 在 节点 控制 台中 直接 发 起 交易 的 时 候 ， 充 当 From 的 也 是 它 。 
Root、TxHash、ReceiptHash: 代表 的 都 是 一 棵 以 太 坊 默 克 尔 前 级 (MPT ) 树 的 根 节 点 哈 希 ， 
有 关 它 们 更 深层 的 含义 会 在 下 面 一 节 中 进行 介绍 。 

Difficulty: 以 太 坊 部 分 代码 在 基于 POW 共识 情况 下 的 挖 矿难 度 系数 ,代表 了 区 块 被 挖 出 矿 的 
难度 ， 这 个 系数 会 根据 出 块 速度 来 进行 调整 。 以 太 坊 第 一 个 区 块 的 难度 系数 是 131072， 后 面 
区 块 的 难度 系数 会 根据 前 面 区 块 的 出 块 速度 进行 调整 ， 快 高 慢 低 。 

Number: 区 块 号 ， 不 能 理解 为 区 块 的 id， 因为 Number 并 不 是 完全 唯一 的 。 例 如 ， 在 几 个 私 
有 节点 中 ， 每 个 节点 会 各 自控 出 自己 节点 网 络 中 Number 顺序 递增 的 区 块 ， 此 时 的 Number 
就 会 在 不 同 的 节点 网 络 中 出 现 一 样 的 情况 ,而 区 块 的 id, 一 般 我 们 认为 是 它 的 区 块 哈 希 值 (block 
hash) 。 另 外 ， 当 前 子 区 块 的 Number， 在 关系 方面 等 于 在 它 父 区 块 的 Number 上 加 1, 
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e Time: 区 块 的 生成 时 间 。 请 注意 ， 这 个 时 间 不 是 区 块 真正 生成 的 精确 时 间 ， 这 个 时 间 可 能 是 
父 区 块 的 生成 时 间 加 上 N 秒 ， 把 它 称 为 区 块 的 大 概 生成 时 间 比 较 准 确 。 

e GasLimit: 区 块 Header 中 的 GasLimit 和 交易 中 的 GasLimit 的 含义 不 同 , 请 注意 区 分 。Header 
里 的 GasLimit 是 单个 区 块 允许 的 最 多 交易 加 起 来 的 GasLimit 总 量 ， 即 区 块 GasLimit > 当 
前 区 块 所 有 的 Transaction ( 交易 ) 的 GasLimit 之 和 ,假设 有 5 笔 交 易 , Transaction 的 GasLimit 
分 别 是 10、20、30、40 和 50。 如 果 区 块 的 GasLimit 是 100， 那 么 前 4 笔 交 易 就 能 被 成 功 打 
包 进 入 这 个 区 块 ， 因 为 矿工 有 权 决 定 将 哪些 交易 打包 进 区 块 ; 另 一 个 矿工 也 可 以 选择 打包 最 
后 两 笔 交 多 进入 这 个 区 块 (50+40 ) ， 然 后 将 第 一 笔 交 多 打包 (10 ) 。 如 果 我 们 尝试 将 一 个 
使 用 超过 当前 区 块 GasLimit 的 交易 打包 ,这 笔 交 易 将 会 被 网 络 拒 绝 , 客 户 端 也 会 收 到 GasLimit 
类 的 错误 信息 反馈 。 

e GasUsed: 表示 这 个 区 块 中 所 有 的 打包 交易 Transaction 实际 消耗 的 Gas 总 量 ， 它 和 GasLimit 
的 关系 可 以 表示 为 公式 : GasUsed < GasLimit。 也 就 是 说 ，GasLimit 虽然 表示 了 一 个 总 的 限 
制 值 , 但 是 实际 共 占 了 多 少 还 是 要 看 GasUsed 的 值 . 它 的 计算 方式 将 会 在 “GasUsed 的 计算 ” 
一 节 中 进行 详细 讲解 。 

e Extra; 该 变量 用 于 为 当前 区 块 的 创建 者 保留 附属 信息 。 例 如 ， 节 点 A 产生 了 区 块 |， 然后 A 
向 Extra 中 加 上 附属 信息 : 这 是 节点 A 产生 的 区 块 。 

e Nonce: 英文 解释 是 “临时 工 ”， 但 它 所 表示 的 作用 和 “临时 工 ” 无 半点 类 似 。 注 意 ，Header 
的 Nonce 和 交易 中 的 Nonce 代表 的 含义 是 不 一 样 的 ，Header 的 Nonce 主要 用 于 PoW 共识 情 
况 下 的 挖 矿 ， 用 于 记录 在 该 区 块 的 政工 做 了 多 少 次 哈 布 才 成 功 计算 出 胜出 区 块 B， 例 如 区 块 
B 的 Nonce 是 200。 而 交易 中 的 Nonce 才 是 我 们 需要 重点 理解 的 ， 有 关 交 易 中 的 Nonce 将 会 
在 下 面 的 一 节 中 解析 。 得 出 正确 值 所 计算 的 总 次 数 ， 例 如 A 矿工 计算 了 200 次 。 


2.4.2 以 太 坊 地 址 (钱包 地 址 ) 


在 Header 结构 体 中 有 一 个 Coinbase 变量 ， 其 本 质 上 是 一 个 字符 长 度 为 42 的 十 六 进 制 地 址 值 。 
在 以 太 坊 中 , 每 一 个 账户 包括 智能 合约 都 有 一 个 唯一 标识 目 己 的 地 址 值 , 通过 这 个 地 址 值 可 以 使 用 
以 太 坊 的 RPC 接口 查询 到 相关 的 信息 。 这 个 地 址 值 有 如 下 规则 : 


C12 Ox 开头 。 

(2) 除 Ox 这 两 个 字符 外 ， 剩 下 的 部 分 必须 是 由 字母 (a~f) 和 数字 〈0~9) 组 成 的 40 个 字符 。 
其 中 ， 字 母 不 区 分 大 小 写 。 

GB) 整体 是 一 个 十 六 进 制 字 符 串 。 


例如 0x24602722816b6cad0el43ce9fabf3116012ec622 就 是 一 个 以 太 坊 的 合法 地 址 ， 而 
0x24602722816b6cad0e143ce9fabf31f6026ec6xy 就 不 是 一 个 合法 的 地 址 ， 因 为 它 最 后 的 两 位 字符 是 
xy， 不 是 十 六 进 制 字符 。 

通常 ， 又 称 上 和 面 的 以 太 坊 地 址 为 一 个 钱包 地 址 ， 因 为 转账 交易 就 是 通过 这 个 地 址 来 转 给 别人 
的 。 在 这 一 点 上 ， 类 似 银行 卡 的 卡号 ， 即 银行 需要 银行 卡 的 卡号 才能 给 对 方 转账 。 
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1. 地 址 的 作用 
地 址 的 作用 主要 有 下 面 几 点 : 


(1) 唯一 标识 一 个 账 尸 或 智能 合约 。 
(2) 作为 标识 ， 可 用 于 得 询 该 账户 的 相关 信息 ， 例 如 代 币 余额 、 交 易 记 录 等 。 
(3) 进行 以 太 坊 交易 时 ， 充 当 交 易 双方 的 唯一 标识 。 


参考 图 2-10 所 示 。 


ore Info 


3.082144302399349768 Ether D My Name Tag Not Available, login to update 


$722 70 (@ $234 A&/ETH) 地 址 值 


Value 


0x47c49269c60 OU 0x642564b27: 0.1 Ether 


753418 1 day 17 hrs ago 0x47c49269c60 U 0x31547aa299 0.12 Ether 


668457 14days 23 hrs ago 0x47c49269c60 2.80148 Ether 


219 — 422 days 2 hrs ago 0x31547aa299 IN 0x47c49269c60 0.051 Ether 


图 2-10 根据 以 太 坊 地 址 查询 交易 记录 


地 址 分 为 两 类 : 非 智 能 合约 地 址 与 智能 合约 地 址 (又 称 为 外 部 账户 和 合约 账户 ，。 那 么 如 何 
判断 一 个 地 址 是 不 是 合约 地 址 呢 ? 判断 方法 可 以 使 用 以 太 坊 源码 提供 的 “eth_getCode” 接 口 ， 关 
于 该 接口 将 会 在 “重要 接口 的 含义 详解 ”一 节 中 讲解 。 

2. 地 址 的 生成 

地 址 分 为 合约 地 址 和 非 合 约 地 址 。 在 以 太 坊 的 账户 体系 中 ， 不 同 种 类 的 地 址 生成 方式 是 不 同 
的 。 比 如 ， 在 生成 钱包 地 址 〈 非 合约 地 址 ) 的 时 候 ， 首 先 要 根据 非 对 称 加 密 算 法 CAsymmetric 
Cryptographic Algorithm) 中 的 椭圆 曲线 算法 生成 私 钥 和 公 钥 ， 再 从 公 钥 的 哈 希 结果 中 提取 后 20 个 
字 节 作为 非 合约 地 址 。 

以 太 坊 非 合约 地 址 (外 部 账户 地 址 〉 的 生成 流程 总 结 如 下 : 


CD 随机 产生 一 个 私 铀 ，32 个 字 节 。 

(2) 计算 得 到 私 钥 在 ECDSA-secp256k1 椭圆 曲线 上 对 应 的 公 钥 。 

(3) 对 公 钥 做 SHA3 计算 ， 得 到 一 个 哈 希 值 ， 取 这 个 哈 希 值 的 后 20 个 字 节 来 作为 外 部 账户 
的 地 址 。 


乔 能 合约 地 址 的 生成 流程 如 下 : 
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(1) 使 用 “rlp” 算 法 将 (合约 创建 者 地 址 + 当前 创建 合约 交易 的 序列 号 Nonce) 进行 序列 化 。 
(2) 使 用 Keccak256 将 步骤 1 的 序列 化 数据 进行 哈 希 运算 ， 得 出 一 个 哈 希 值 。 
G) HUS (OD 步 的 哈 希 值 的 前 12 字 节 之 后 的 所 有 字 节 生成 地 址 ， 即 后 20 ^r 5. 


非 合约 地 址 和 合约 地 址 生成 方式 的 区 别 是 : 合约 地 址 和 椭圆 曲线 加 密 无 关 ， 因 为 合约 地 址 是 
基于 用 户 地 址 和 交易 序列 号 的 ， 所 以 也 不 会 生成 雷同 的 地 址 。 

大 家 可 能 还 会 问 , 为 什么 非 合约 地 址 要 搞 这 么 复杂 还 这 么 难 读 , 像 银 行 卡 的 卡号 一 样 不 行 吗 ? 

非 合约 地 址 之 所 以 刹 守 上 述 的 生成 规则 ， 主 要 原因 是 私 钥 几 乎 为 0 概率 的 重复 性 。 私 钥 是 通 
过 伪 随 机 算法 (PRNG) 产生 的 ， 所 生成 的 私 钥 以 二 进 制 的 形式 表示 ， 一 共有 256 位 〈 即 32 个 字 
节 ) ， 即 256 个 0 和 1 组 成 ， 它 的 可 能 性 有 2 个 ， 此 数 非常 庞大 ， 比 宇宙 中 的 原子 数量 还 要 多 出 
几 十 个 数量 级 。 在 这 种 情况 下 ， 可 以 100% 保 证 账 尸 不 重复 。 此 外 ， 十 六 进 制 形 式 的 地 址 也 便于 程 
序 读 写 。 


2.4.8 Nonce 的 作用 


上 一 节 我 们 已 经 了 解 了 区 块 结构 Header 中 的 Nonce， 也 提 到 了 交易 中 的 Nonce， 它 们 两 个 是 
不 一 样 的 。 区 块 Header 中 的 Nonce 主要 用 于 PoW 共识 情况 下 的 挖 矿 ， 交 易 中 的 Nonce 指 的 是 我 
们 在 调用 以 太 坊 的 交易 RPC 接口 进行 转发 操作 时 所 要 传 市 的 参数 ， 它 代表 了 “交易 的 系列 号 ” 


交易 中 的 Nonce 是 相对 于 from 发 送 者 地 址 而 言 的 , 它 代表 当前 发 送 者 的 账户 在 节点 网 络 中 总 
的 交易 序号 ， 每 个 发 送 者 地 址 都 有 一 个 Nonce. from 的 格式 就 是 前 面 讲 到 的 地 址 格式 ， 例 如 
0x24602722816b6cad0e143ce9fabf31f6012ec622 . 

进一步 举例 说 明 : 

在 以 太 坊 主 网 (也 就 是 在 公 链 ) 的 环境 下 ， 例 如 账户 A， 第 一 次 进行 交易 ， 此 时 它 的 Nonce 
为 0. 交易 成 功 后 , 它 要 进行 第 二 笔 交 易 ， 此 时 发 起 交易 的 时 候 Nonce 为 1. 成功 后 ,下 一 次 Nonce 
为 3， 一 直 以 此 类 推 下 去 。 这 里 只 考虑 了 每 一 笔 都 是 成 功 的 情况 ， 事 实 上 还 有 一 种 等 待 状态， 此 时 
的 Nonce 有 其 他 的 选择 。 男 外 ， 在 不 同 的 链 和 不 同 的 节点 网 络 中 ，Nonce 也 不 一 样 。 

Nonce 的 特点 是 , 在 顺序 不 断 递 增 的 交易 订单 中 , 每 一 次 传输 必须 要 满足 比 上 一 次 成 功 交 易 的 
Nonce EZK. 注意 这 里 的 一 个 条 件 ， 比 上 一 次 成 功 的 交易 大 ,其 一 般 采 取 加 1 累 增 的 方式 。 例 如 ， 
上 面 的 例子 ， 在 第 二 次 发 起 交易 的 时 候 ，Nonce 不 能 再 为 0， 耕 则 ， 以 太 坊 会 返回 错误 ， 导 人 致 交易 
失败 。 可 以 取 3 吗 ? 可 以 , 但 是 如 果 取 3， 必须 等 Nonce 为 ! 和 2 的 交易 被 节点 处 理 完成 后 才能 轮 
到 Nonce 为 3 的 交易 。 

因此 ， 在 每 一 笔 成 功 的 交易 中 都 有 一 个 特定 的 Nonce 与 之 对 应 ， 这 样 可 以 有 效 地 分 辨 出 哪些 
是 被 重复 发 起 的 交易 ， 以 方便 进行 处 理 。 

综 上 所 述 ， 交 易 中 Nonce 的 作用 主要 有 两 点 : 


(OD 作为 交易 接口 的 参数 。 
(2) 代表 每 次 交易 的 序列 写 ， 方 便 节 扣 程 序 处 理 被 重复 发 起 的 交易 。 


FÉ Nonce 的 取 值 规则 : 
(1) 如 果 Nonce 比 最 近 一 次 成 功 交 易 的 Nonce 要 小 ， 转 账 出 锐 。 


34 | 区 块 链 以 太 坊 DApp 开发 实战 


(2) 如 果 Nonce 比 最 近 一 次 成 功 交 易 的 Nonce 大 了 不 止 1， 那 么 这 次 发 起 的 交易 就 会 长 久 处 
于 队列 中 , 此 时 就 是 等 待 (Pending, 或 称 为 挂 起 ) 状态 ! 在 补 齐 了 此 Nonce 到 最 近 成 功 的 那个 Nonce 
值 之 间 的 Nonce 值 后 ， 此 交易 依旧 可 以 被 执行 。 

(GO 还 处 于 队列 中 的 交易 , 在 其 他 节点 的 缓存 尚未 收 到 并 留存 这 次 交易 的 广播 信息 的 情况 下 ， 
如 条 此 时 这 个 发 起 交易 的 节点 “ 挂 ” 了 【就 是 宕 机 了 或 者 脱 网 了 ) ， 那 么 还 没 被 处 理 的 这 次 交易 将 
会 丢失 ， 因 为 此 时 的 交易 存放 于 内 存 中 尚未 广播 出 去 。 

(4) 处 于 等 待 (Pending) 状态 的 交易 ， 如 果 其 Nonce 相同 ， 就 会 引发 节点 程序 对 交易 的 进 一 
步 判 新， 通 和 会 选 出 燃料 费 最 高 的 ， 蔡 换 反 燃料 费 低 的 《注意 : 前 文 与 Gas 相关 的 变量 ， 就 是 指 
燃料 ， 以 及 相关 的 燃料 费 ， 下 一 节 会 详细 说 明 ) 。 


2.4.4 ”燃料 费 


燃料 费 给 我 们 最 直观 的 感知 就 是 日 第 生活 中 汽车 所 使 用 的 汽油 的 费用 ， 即 在 加 油 时 付 给 加 油 
站 的 油 费 。 以 太 坊 中 的 燃料 费 也 可 以 这 么 理解 (以 太 坊 中 习惯 称 为 燃料 费 而 不 是 油 费 〉。 

在 以 太 坊 中 ， 燃 料 费 付 给 的 不 是 加 油 站 ， 而 是 节点 中 的 矿工 。 我 们 付 给 矿工 燃料 费 的 目的 是 
让 矿工 帮助 处 理 交 易 订 单 ， 把 交易 订单 打包 到 区 块 中 去 。 注 意 这 段 话 中 的 关键 词 “交易 订单 ”, 不 
是 转账 ， 转 账 是 交易 的 真子 集 。 

以 太 坊 中 的 燃料 费 又 称 为 手续 费 ， 瑞 文 单词 对 应 的 是 “Gas”。 它 是 用 来 激励 矿工 把 交易 订单 
打包 到 区 块 中 而 付 给 矿工 的 打包 费 。 此 外 ,燃料 费 的 高 低 会 影 啊 当 前 交易 订单 被 打包 的 速率 ， 高 燃 
料 费 的 交易 订单 将 会 优先 被 矿工 打包 进 区 块 , 以 太 坊 使 用 这 种 价 高 者 优先 的 策略 保证 了 矿工 利益 的 
最 大 化 。 

在 交易 时 ， 燃 料 费 或 手续 费 Gas (单位 是 wei) 并 不 属于 交易 函数 的 参数 ， 它 的 计算 方式 是 : 


GasUsedX GasPrice=Gas 


我 们 可 以 采用 下 面 的 例子 来 进一步 理解 GasUsed 和 GasPrice 的 关系 ,假设 GasUsed 代表 的 是 
苹果 的 数量 ， 那 么 每 个 苹果 的 单价 就 是 GasPrice。 买 了 10 个 人 苹果， 这 10 个 苹果 的 总 价格 就 是 “ 数 
量 ” 乘 以 “单价 ”， 最 终 的 总 价 就 是 Gas， 也 就 是 GasUsed X GasPrice。 

公式 中 的 GasUsed 和 GasPrice 在 以 太 坊 中 有 两 种 解析 ， 分 别 是 : 


(1) 基于 区 块 Header 的 解析 。 
(2) 作为 以 太 坊 交易 图 数 入 参 (Input Parameter). 的 解析 。 


第 一 种 解析 ， 在 前 文 介绍 Header 区 块 时 已 介绍 过 。 第 二 种 解析 ， 在 以 太 坊 交易 中 ， 当 前 的 交 
易 被 矿工 打包 到 区 块 中 时 ， 究 竟 要 付 给 矿工 多 少 Gas 手续 费 ， 实 际 上 和 交易 图 数 GO) MiA 
的 参数 有 关 。 交 易 订 单 被 矿工 打包 进 区 块 中 时 消耗 的 是 GasUsed， 代 表 实 际 使 用 了 多 少 燃料 ， 
GasPrice 指 单 价 ， 两 者 的 乘积 就 是 Gas 燃料 费 的 真实 值 。 

那么 ， 为 什么 以 太 坊 的 矿工 打包 要 消耗 Gas， 直 接 打 包 不 就 行 了 吗 ? 这 里 的 原因 如 下 : 

CD. 弥补 计算 机 资源 消耗 的 代价 ， 因 为 以 太 坊 公 链 允许 每 个 人 到 上 面 进行 交易 ， 这 些 交 易 的 
背后 依赖 的 是 代码 ， 而 代码 的 运行 自然 依赖 计算 机 资源 ， 例 如 我 们 常见 的 服务 器 费用 。 

(2) 防止 不 法 分 子 对 以 太 坊 网 络 荔 意 攻 击 或 渴 用 ， 以 太 坊 协议 规定 交易 或 合约 调用 的 每 个 运 
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算 步 又 都 需要 收费 ， 以 增加 攻击 代价 。 
但 是 ， 请 注意 ， 以 太 坊 上 的 操作 并 非 都 要 扣除 燃料 费 才能 进行 ， 和 常见 的 需要 扣除 燃料 费 的 情 
况 有 : 
(1) 交易 类 型 的 ETH 或 ERC20 代 币 转账 。 
(2) 发 布 智能 合约 。 
(3) ERC20 代 币 授权 。 
从 最 直观 的 代码 的 角度 来 看 ， 扣 除 燃 料 费 的 操作 有 一 个 共同 点 一 一 它们 都 是 通过 调用 以 太 坊 
的 “eth sendTransaction ”或 “eth sendRawTransaction” 接 口 实现 的 。 
此 外 wei 是 Gas 的 单位 ， 它 和 ETH 的 对 应 关系 如 图 2-11 所 示 。 
Wei 


1 wel 


Kwei (babbage) 1e3 wei 1,000 


Mwei (lovelace) 1e6 wei 1,000,000 


Gwei (shannon) 1e9 wei 1,000,000,000 
microether (szabo) 1e12 wei 1,000,000,000,000 


milliether (finney) 1e15 wei 1,000,000,000,000,000 


ether 1e18 wei 1,000,000,000,000,000,000 


2-11 燃料 费 单位 的 换算 


图 2-11 中 的 ether 就 是 一 个 ETH，1leX 代表 的 是 10 的 多 少 次 方 。 


2.4.5 GasUsed 的 计算 


由 燃料 费 的 计算 公式 GasUsed X GasPrice = Gas 可 知 , 真 正 影响 燃料 费 计 算 结果 的 是 GasUsed。 
GasUsed 的 计算 是 比较 复杂 的 ， 主 要 分 为 两 部 分 : 


CD 数据 量 部 分 ， 对 应 交易 函数 中 的 “data” 入 参 (Input Parameter) 。 
(2) 虚拟 机 EVM) 执行 指令 的 部 分 。 


从 源码 中 可 以 看 到 〈 见 图 2-12) ， 对 于 每 一 笔 交 易 中 的 数据 量 部 分 的 燃料 费 是 通过 统计 不 同 
类 型 的 字 节 来 计算 的 ， 这 部 分 还 有 一 个 影响 计算 的 基础 量 ， 就 是 默认 的 燃料 费 数值 ， 分 下 面 两 种 情况 : 


// Per transaction not creating a contract. 
// NOTE: Not payable on data of calls between transactions. 
TxGas uint64 - 21000 


// Per transaction that creates a contract. 
// NOTE: Not payable on data of calls between transactions. 
TxGasContractCreation uint64 = 53000 


2-12. 不 同 交易 类 型 的 燃料 费 起 始 值 
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(1) 创建 合约 的 交易 ， 基 础 量 为 53000. 
(2) 非 创 建 合 约 的 交易 ， 基 础 量 为 21000。 


当 我 们 在 交易 函数 中 设置 的 GasLimit 比 基 础 量 还 要 小 时 ， 就 会 导致 交易 失败 ， 出 现 的 错误 信 
AE "intrinsic gas too low”【〔 固 有 的 燃料 太 少 了 〉; 随后 在 这 个 基础 量 的 前 提 下 ， 对 数据 所 占有 
的 字 节 量 计算 燃料 费 ， 计 算 的 方式 也 按照 以 太 坊 设置 的 规则 ， 即 : 


(1) 0 字 节 的 收费 是 4， 每 发 现 一 个 0 字 节 ， 基 础 量 累加 4。 
(2) 非 0 字 节 的 收费 68， 每 发 现 一 个 非 0 字 节 ， 基 础 量 些 加 68. 
具体 设置 如 图 2-13 所 示 。 


Overview Comments 
Block Height: 6670988 < » 
Timestamp © 187 days 22 hrs ago (Nov-09-2018 07:09:58 AM +UTC) 


Transactions: 


Mined by: 打包 了 的 交易 数量 0x4bb96091ee9d802ed039c4d1a5f6216f90f81b01 (Ethpool 2) in 5 secs 


Block Reward: 3.143290272928818416 Ether (3  0.049540272928818416 + 0.09375) 
三 部 分 奖励 


Uncles Reward: 1.875 Ether (1 uncle at Position 0) 


Difficulty: 2,955,240,733 037,238 


Total Difficulty: 7,706,121.856 488,461,535,198 


2-3. ”燃料 费 的 计算 
第 一 部 分 燃料 费 的 计算 是 发 生 在 交易 被 添加 进 订 单 池 之 前 ， 也 是 在 第 一 部 分 数据 量 所 占有 燃 
料 费 的 数值 计算 结束 之 后 。 
对 于 第 二 部 分 的 虚拟 机 CEVMO 执行 指令 的 计 复 过 程 发 生 的 时 机 ， 目 前 有 两 种 情况 : 
(1) 在 以 太 坊 的 矿工 (Miner) 模块 从 交易 池 中 取出 交易 准备 打包 到 区 块 中 之 前 。 
(2) 将 区 块 插入 区 块 链 之 前 需要 验证 区 块 的 合法 性 。 


如 图 2-14 所 示 ， 用 于 计算 虚拟 机 CEVMO 燃料 费 的 入 口 代码 片段 位 于 源码 文件 
g0-ethereum\core\state_transition.go 中 的 TransitionDb 国 数 内 ， 该 图 数 对 不 同 的 交易 进行 了 对 应 的 虚 
拟 机 操作 ， 对 于 合约 交易 便 执行 “evm.Create”， 对 于 非 合约 交易 则 执行 “evm.Call”， 这 两 种 操 
作 最 终 都 返回 了 “stgas” 燃 料 的 消耗 量 。 
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// Pay intrinsic gas 
/ PERE RG H gas (53000/21000) iih HAE T HE 
gas, err :z st.data, contractCreation, 
if err != nil { 

return ret: nil, 
} 


// st.gas - gas = (Limit - Miu 
if err = st.useGas(gas); err !- nil ( 
return ret nil, usedGas:0, failed: false, err 


: |j gas 
homestead) 


usedGas: 0, failed: false, err 


- A 


) 


var ( 
evm = st.evm 
vmerr error 


) 


/ AORE EIR] CEEI A PTU 36 IF. SÓZSTD AIDS J 1 


/j PEAX AHI st.gas TEA IEY 
if contractCreation { 
ret, _, st.gas, vmerr 


=|evm.createķsender, st «date, | st.gas,| st.value) 
) else ( 


// Increment the nonce for the next transaction 

st.state.SetNonce(msg.From st.state.GetNonce(sender.Address())*1) 

ret, st.gas, vmerr eu pid st.to(), ghi er RUNE 
图 2-14 用 于 计算 虚拟 机 燃料 费 的 入 口 代码 


虚拟 机 (EVM) 执行 指令 部 分 的 燃料 费 计 算是 最 为 复杂 的 。 虚 拟 机 EVM) 事务 执行 期 间 的 
所 有 操作 ,包括 数据 库 读 写 、 消 奶 发 送 以 及 虚拟 机 采取 的 每 个 计算 步骤 都 要 消耗 一 定量 的 燃料 ， 并 
且 在 不 同 参数 和 组 存 影响 的 情况 下 都 会 对 应 有 不 同 的 燃料 标价 。 图 2-15 是 取 目 以 太 坊 官方 黄皮书 
中 的 非 指 令 部 分 的 燃料 标价 示例 图 。 

黄皮书 链接 : https://ethereum.github.io/yellowpaper/paper.pdf 


The fee schedule G is a tuple of 31 scalar values corresponding to the relative costs, in gas. of a number of abstract 
operations that a transaction may effect. 


Name 


G: ero 
Chase 
Gveryiow 
Cows 
Gmid 
Ghigh 
Cert code 
Ghata nce 
Gaload 

G; umpdest 


G. set 
G, resct 


Rddear 


Rsetfdestruct 
G. el fdestruct 
Gereate 
Geodedepoait 
G'cau 
Geallvalue 
G: allstipend 
Gne waccount 
* RN 
Gezpbyte 


Gmemory 
Gi xcreate 


Gsdatesero 


Gtrda tanonzero 
Gi ransaction 
Giog 

Giogdata 
Giogtopie 

G'sha3 

Gs ha3word 
Geopy 

Gbiockha sh 

Go uaddivisor 


Value 


图 2-15 


Description* 

Nothing paid for operations of the set Wi... 

Amount of gas to pay for operations of the set Whase. 

Amount of gas to pay for operations of the set Weryiow. 

Amount of gas to pay for operations of the set Wiow. 

Amount of gas to pay for operations of the set W,, ;4. 

Amount of gas to pay for operations of the set Whigh- 

Amount of gas to pay for operations of the set W, 4. . 

Amount of gas to pay for a BALANCE operation. 

Paid for a SLOAD operation. 

Paid for a JUMPDEST operation. 

Paid for an SSTORE operation when the storage value is set to non-zero from zero. 
Paid for an SSTORE operation when the storage value's zeroness remains unchanged or 
is set to zero. 

Hefund given (added into refund counter) when the storage value is set to zero from 
non-zero. 

Refund given (added into refund counter) for self-destructing an account. 

Amount of gas to pay for a SELFDESTRUCT operation. 

Paid for a CREATE operation. 

Paid per byte for a CREATE operation to succeed in placing code into state. 

Paid for a CALL operation. 

Paid for a non-zero value transfer as part of the CALL operation. 

A stipend for the called contract subtracted from Crrvatuec for a non-zero value transfer. 
Paid for a CALL or SELFDESTRUCT operation which creates an account. 

Partial payment for an EXP operation. 

Partial payment when multiplied by [log;s;(exponeni)] for the EXP operation. 
Paid for every additional word when expanding memory. 

Paid by all contract-creating transactions after the Homestead transition. 

Paid for every zero byte of data or code for a transaction. 

Paid for every non-zero byte of data or code for a transaction. 

Paid for every transaction. 

Partial payment for a LOG operation. 

Paid for each byte in a LOG operation's data. 

Paid for each topic of a LOG operation. 

Paid for cach SHA3 operation. 

Paid for each word (rounded up) for input data to a SHA3 operation. 

Partial payment for *COPY operations, multiplied bv words copied. rounded up. 
Payment for BLOCKHASH operation. 

'The quadratic coefficient. of the input sizes of the exponentiation-over-modulo precompiled 
contract. 


指令 及 其 对 应 的 燃料 费 标价 和 描述 


图 2-16 是 指令 部 分 的 燃料 费 标 价 。 
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const ( 
GasQuichStep ^ uint6 
GasFastestStep uint6 
GasFastStep uint6 
GasMidStep 
GasSLowStep 


N F5 OVUN 
© c 


GasExtStep 


GasReturn 
GasStop 
GasContractByte uint64 


图 2-16 指令 部 分 的 燃料 费 标 价 


可 以 看 到 ，GasUsed 的 计算 在 虚拟 机 部 分 是 相当 复杂 的 ， 要 想 了 解 完整 的 计算 过 程 ， 建议 阅读 
以 太 坊 虚拟 机 (EVM) 调用 链 的 源码 。 


2.4.6 BUR 


JU (Uncle Block) 的 概念 ， 目 前 只 有 以 太 坊 中 有 。 图 2-17 是 在 区 块 链 分 又 一 节 中 介绍 的 分 
又 模型 。 


图 2-17 分 又 的 链 
图 2-17 中 导致 链 分 叉 的 是 分 又 区 块 4， 根 据 最 优 链 选择 规则 ， 在 把 造成 分 又 链 的 区 块 4 抛弃 


后 ， 它 就 成 为 了 “ 孤 块 ”， 如 图 2-18 Pr. 


区 块 4 ik 


图 2-18 Jk 
扳 块 在 比特 币 区 块 链 中 也 是 存在 的 ， 因 为 比特 币 公 链 也 有 分 又 的 情况 ， 但 是 在 比特 币 区 块 链 
中 ， 挖 出 孤 块 的 矿工 节点 是 得 不 到 BTC 奖励 的 ， 也 就 是 没有 任何 奖励 。 而 以 太 坊 区 块 链 不 是 这 样 
的 ， 以 太 坊 区 块 链 中 挖 出 孤 块 的 矿工 也 有 获得 ETH 奖励 的 可 能 性 ， 这 是 两 者 的 差异 。 
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孤 块 在 以 太 坊 区 块 链 中 是 有 机 会 成 为 板块 的 ， 当 一 个 孤 块 被 另 一 个 符合 层级 限制 内 的 区 块 采 
纳 为 板块 的 时 候 ， 挖 出 这 个 扳 块 的 矿工 就 会 获得 以 太 坊 ETH 奖励 ， 此 时 的 孤 块 也 就 变 成 了 叔 块 。 

那么 为 什么 称 为 “ 叔 ” 而 不 是 其 他 名 称 呢 ? 这 里 实际 上 是 类 比 了 人 类 的 亲戚 关系 。 如 图 2-19 
所 示 , 主 链 中 的 区 块 4 和 变 成 了 叔 块 的 区 块 4 拥有 相同 的 区 块 高 度 ， 束 是 高 度 4, 因为 分 又 的 原因 ， 
导致 权 块 4 最终 变 成 了 主 链 区 块 4 的 附属 块 ， 对 于 区 块 5 来 说 , 主 链 的 区 块 4 才 是 它 的 父 区 块 ， 而 
由 于 同 级 关系 ， 相 对 于 区 块 5 来 说 ,区 块 4 的 附属 块 都 是 它 的 “叔叔 ”级 别 的 块 ， 故 称 为 “ 叔 块 ”。 


2-19 分 又 状态 的 链 


1. 打包 规则 
假设 要 将 分 又 区 块 A 打包 成 为 区 块 B 的 叔 块 ， 在 代码 层面 就 是 在 区 块 B 的 Header 中 ， 将 区 
Jk A 的 数据 绑 定 到 区 块 B 的 Uncle 变量 字段 中 ， 卜 块 打包 的 规则 如 下 ，。 
(1) BG A 必须 是 区 块 B 的 第 X 层 祖先 的 同 层级 高 度 的 分 叉 区 块 ，2<=X<=7， 参 考 图 2-20 
所 示 。 
第 1 层 ， 分 又 的 区 块 7 达 不 到 主 链 区 


TRUM, (Bie 2-6 可 以 被 
主 链 的 区 块 7 打包 成 7 8933 


人 


第 7 层 第 6 层 第 5 层 第 4 层 第 3 层 第 2 层 


\ X \ \ ` A 
` ` ` ` A A 
V A A A A ` 
A X ` x Y E 
\ 区 块 | ` 区 块 
2 7 


220 叔 块 的 打包 范围 


(2) 区 块 A 必须 有 合法 的 “Block Header" 〈 区 块头 部 ) 。 

(3) 区 块 A 必须 还 没 成 为 过 别 的 区 块 的 板块 。 

(4) 区 块 B 已 经 打包 了 的 叔 块 必 须 还 没有 达到 2 个 的 数量 , 即 一 个 区 块 最 多 只 能 有 2 个 叔 块 。 

C5) X Et A 一旦 成 为 叔 块 , 当 它 作为 分 叉 区 块 时 , 打包 了 的 交易 会 重新 回 到 节点 的 交易 池 中 ， 
等 待 重 新 被 打包 到 区 块 内 。 
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2. 奖励 规则 

叔 块 的 奖励 规则 是 由 以 太 坊 的 “Ghost 协议 ” 也 称 为 幽灵 协议 ) 制定 的 ， 控 出 叔 块 的 矿工 可 
以 获得 奖励 。 控 出 叔 块 的 矿工 的 奖励 机 制 ， 它 的 奖励 计算 公式 如 下 : 

(uncleNumer--8-headerNumber) X blockReward/8 

上 述 公 式 中 的 3 个 变量 说 明 如 下 : 

e uncleNumber: 代表 当前 叔 块 的 高 度 ， 也 就 是 它 的 区 块 号 。 

* headerNumber: 代表 当前 正在 被 打包 的 区 块 的 高 度 。 

€  blockReward: 代表 矿工 挖 出 区 块 时 的 基础 奖励 值 ,现在 是 3ETH( 有 君 士 坦 丁 堡 版 本 后 是 2ETH )， 

曾经 是 SETH。 
e 满足 关系 : headerNumber-6 < uncleNumber < headerNumber-1 , 


假设 headerNumber-17, 那么 uncleNumber 的 高 度 范围 是 11<uncleNumber<16, 奖励 公式 的 取 
值 范围 是 (2/8~7/8)*blockReward。 

由 于 这 个 规则 ， 导 致 了 叔 块 的 奖励 也 有 对 应 的 层级 ， 当 基础 奖励 值 blockReward 是 3ETH 的 时 
修 ， 它 的 奖励 层级 表 如 表 2-1 所 示 。 


表 2-1 奖励 层级 表 


叔 块 存 在 的 意义 有 二 : 一 是 基于 挖 矿 市 扩 奖 励 回 馈 ， 二 是 保持 生态 发 展 平衡 。 以 太 坊 为 了 将 
出 块 时 间 纵 短 ， 导 致 了 软 分 又 的 出 现 更 加 频 绎 ， 叔 块 被 产生 的 概率 就 比较 蜗 ， 如果 类 似 比 特 币 的 设 
计 ， 对 产生 叔 块 的 矿工 不 给 予 奖励 就 会 有 很 多 矿工 因为 产生 了 玻 块 而 获取 不 到 任何 奖励 , 积极 性 
降低 ， 不 利于 以 太 坊 生态 的 发 展 ， 所 以 以 太 坊 团队 引入 了 叔 块 的 概念 。 

在 以 太 坊 的 挖 矿 过 程 中 ， 叔 块 的 奖励 只 是 其 中 的 一 部 分 ， 完 整 的 挖 矿 奖 励 机 制 将 会 在 下 一 节 
中 进行 详细 说 明 。 


2.4.7 FW Xl) 


挖 矿 是 应 用 了 PoW 共识 算法 的 区 块 链 所 特有 的 操作 ,因为 以 太 坊 目前 的 共识 算法 主要 是 PoW， 
所 以 以 太 坊 的 区 块 也 是 徘 节 点 矿工 挖 矿 产生 的 。 

挖 矿 成 功 了 ， 目 然 也 就 有 收入 了 ， 这 也 是 符合 达 动 获取 规则 的 。 在 以 太 坊 中 ， 所 有 挖 矿 成 功 
的 节点 都 会 被 奖励 以 太 坊 代 币 ETH， 这 些 ETH 将 会 像 工 资 一 样 打 入 到 当前 节点 所 设 管 的 用 于 收 著 
的 以 太 坊 钱包 地 址 中 去 。 

打包 了 不 同 的 区 块 就 拥有 不 同 的 奖励 模式 ,目前 以 太 坊 通过 挖 矿 出 来 的 区 块 主要 有 下 面 三 种 ， 
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其 中 只 有 两 种 能 够 得 到 奖励 : 


(1) 普通 的 成 功 进 入 主 链 的 区 块 ， 有 ETH 奖励 。 
(2) i ESE BUT] SUR X CES, A ETH 奖励 。 
(3) WMH, RAH 


Fifi 4L 12 2 E A UOS PCBCRUBURUT] 3p. 普通 区 块 的 ETH 奖励 由 3 个 部 分 组 成 , 分 别 是 : 


CD 被 设置 好 了 的 固定 的 挖 矿 奖励 ， 即 “Block Reward” (KHD) ， 这 个 值 在 以 太 坊 早 
期 的 时 候 ， 节 点 规范 设置 是 5ETH， 后 和 面 被 设置 为 了 3ETH， 升 级 到 君 士 坦 丁 堡 版 本 后 变 为 2ETH。 

(2) 挖 出 的 区 块 打 包 了 的 所 有 交易 的 燃料 费 〈Gas) 总 和 。 

G) 当前 这 个 区 块 所 打包 了 的 叔 块 的 奖励 ， 每 打包 一 个 叔 块 ， 奖 励 Block Reward X 1/32。 打 
ET NAR, M% hE NX Block Reward X 1/32. 


举 个 例子 ， 假 设 成 功 地 进入 了 主 链 的 普通 区 块 A， 它 内 部 所 有 打包 了 的 交易 (Transaction ) 4 
有 40 个 ， 加 起 来 的 燃料 费 (Gas) Æ 0.65 ETH， 且 它 同时 还 打包 了 1 个 叔 块 ， 最 多 只 能 打包 两 个 。 
那么 此 时 控 出 区 块 A 的 节点 矿工 ， 他 的 ETH 收益 就 是 (3+0.65+3/32) ETH 这 么 多 。 


下 面 我 们 通过 区 块 链 浏 览 器 得 找 一 下 区 块 的 详细 信息 ， 来 验证 一 下 上 面 的 结论 ， 如 图 2-21 所 
示 ， 区 块 信息 链接 是 : https:Wetherscan.io/block/6670988 . 


Overview Comments 


Block information Q6 


Height 6670988 

TimeStamp: 1 min ago (Nov-09-2018 07:09:58 AM «UTC) 

Transactions: 

Hash. OxbddoO52ee62e7c717f129e7c2ab37e34d655848[29ed28568b630a0840c627533 
Parent Hash 打包 了 的 交 另 Oxedaa1a1d311d266234a3bbfd8acecab5aec6ba550f13332b752d5c2€a522b4c01f 
Sha3Uncles: Ox6fd9c0c85700f3d4b2e850tfbfeeb1828e7 11515b0et036a91788e36c92070623 
Mined By Ox4bb96091ee9d802ed039c4d1a5f62 16690181501 (Ethpool 2) in 5 secs 
Difficulty: 2.955.240,733,037 238 

Total Difficulty: 7,106,121,856,488,461,535,198 

Size 10524 byles 

Gas Used 2.942.354 (29.2696) 

Gas Limit: 8,000,029 


Nonce Ox2D8173700d4bceaf 


Block Reward: 3.143290272926618416 Ether (3 + 0.0495402729328818416 + 0.09375) 


Uncles Reward: 1.875 Ether (1 Uncle at Position 0) 


Extra Data: ethpoorasia1 (H&ex:0x657468 7 O6reroc2dó61 73696131 ) 
221 区 块 信息 的 展示 


图 2-21 中 “Block Reward” 对 应 的 就 是 挖 出 区 块 6670988 的 矿工 ， 他 所 获得 的 以 太 坊 ETH 收 
入 ， 对 应 前 面 讲解 的 部 分 ，3 就 是 基础 奖励 ，0.049540272928818416 是 所 有 交易 的 手续 费 收 入 ， 这 
点 可 以 单 击 页 面 中 的 “68 transactions ”链接 ， 进 入 到 交易 列表 页 和 面 统 计 验 证 ， 最 后 的 0.09375 就 是 
3/32 的 结果 。 如 果 该 区 块 打 包 了 两 个 叔 块 ， 那 么 最 后 的 叔 块 收入 就 是 3/32X2。 

图 2-21 中 的 “Uncles Reward” 表 示 控 出 叔 块 的 矿工 ， 他 所 获得 的 以 太 坊 ETH 收入 ， 注 意 叔 
块 奖励 收入 包含 有 下 面 的 两 种 含义 : 
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(1) 控 出 分 又 区 块 的 矿工 的 收入 ， 因 为 分 又 区 块 衫 其 他 区 块 打包 了 ， 它 才 成 为 了 叔 块 。 
(2) 打包 了 分 又 区 块 ， 让 它 成 为 了 叔 块 的 矿工 节点 的 收入 。 


第 一 种 奖励 收入 对 应 的 奖励 计算 公式 就 是 “ 叔 块 ” 一 节 中 所 谈 到 的 。 第 二 种 所 对 应 的 收入 就 
是 BlockReward X 1/32X 叔 块 个 数 。 下 面 我 们 通过 一 个 完整 的 例子 来 认识 挖 矿 奖励 。 

假设 现在 有 两 个 以 太 坊 节点 NT 和 N2, 它 们 所 设置 的 挖 大 收益 的 以 太 坊 地 址 分 别 是 Al 和 A2, 
此 时 N1 成 功 地 控 出 了 区 块 B1， 高 度 是 4， 同 时 N2 也 控 出 了 区 块 B2， 高 度 和 B1 一样 ， 都 是 4， 
根据 最 优 链 规则 ， 最 终 区 块 B2 被 判断 为 分 又 区 块 。 紧 接着 ， 节 点 NI 继续 控 出 了 区 块 B3 和 区 块 
B4， 这 时 属于 节点 N1 的 区 块 B3 把 区 块 B2 打包 成 目 己 的 叔 块 ， 使 得 区 块 B2 不 会 成 为 孤 块 ， 而 区 
Hk B1 和 区 块 B4 都 没有 打包 成 上 板块， 如 图 2-22 所 示 。 


高 度 4 高 度 5 


高 度 6 
B4 
\ 
\ 
\ 
\ 
1*9 | 
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Ajk, TANI 的 收益 地 址 Al 的 总 收益 是 : 

(B1+B2+B3 的 基础 收益 )+(B1+B2+B3 的 所 有 打包 了 的 交易 手续 费 )+B3 打包 了 B2 叔 块 的 收益 
=BlockReward X 3+T1+T2+T3+3/32 

节点 N2 的 收益 地 址 A2 的 总 收益 是 : 

B2 作为 叔 块 的 奖励 = (uncleNumer+8-headerNumber) X blockReward/8 = (4+8-5)X 3/8 = 21/8 = 
2.625， 刚 好 对 应 上 板块 奖励 表格 中 的 第 一 层 痰 励 。 


2.5 ”账户 模型 


账户 模型 不 仅 存 在 于 以 太 坊 技术 模块 中 ， 还 存在 于 比特 币 技 术 模 块 中 ， 它 最 直观 的 体现 就 是 
如 何 和 帮助 钱包 地 址 存储 资产 〈《 代 币 ) 的 数值 。 

在 传统 的 服务 器 端的 服务 设计 中 ， 如 果 我 们 要 为 茶 一 个 用 户 记 录 他 的 资产 余额 信息 ， 例 如 积 
分 的 余额 ,第 见 的 做 法 就 是 直接 在 数据 库 中 设 管 一 张 积 分 表 ， 用 来 存储 用 户 的 积分 。 当 积分 有 增加 
或 使 用 的 情况 时 ， 融 对 表格 记录 进行 更 新 操作 ， 表 中 剩 下 的 数值 束 是 对 应 的 余额 信息 。 

上 面 的 存储 做 法 很 容易 理解 和 接受 ， 但 是 在 区 块 链 中 考虑 到 其 分 布 式 去 中 心 化 的 特点 ， 上 述 
的 表格 做 法 并 没有 被 采用 , 取而代之 的 技术 方案 有 很 多 , 其 中 比较 具有 代表 性 的 是 比特 币 的 UTXO 
模型 和 以 太 坊 的 Account 模型 ， 我 们 把 这 类 模型 称 为 账户 模型 。 

下 面 我 们 主要 对 这 两 种 模型 所 涉及 的 技术 进行 讲解 。 
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2.5.1 比特 币 UTXO 模型 


UTXO (Unspent Transaction Output， 未 花费 的 交易 输出 ) 是 一 种 交易 数据 的 存储 模型 。 目 前 
比特 币 所 采用 的 就 是 它 。 
UTXO 比较 接近 我 们 生活 中 钱财 交易 的 记 账 模式 ， 每 一 条 符合 UTXO 模型 的 交易 记录 都 拥有 
如 下 特点 : 
(1) 每 笔 交 易 拥 有 : 
e 输入 部 分 (Input) 
e 输出 部 分 (Output ) 
(2) 输出 能 够 从 “Unspend” 状 态 转 为 “Spend” 状 态 ， 这 个 过 程 称 为 “被 使 用 ”。“Spend” 
状态 的 输出 会 成 为 男 外 一 条 符合 UTXO 模型 交易 的 输入 部 分 。 
G) 输出 部 分 包含 : 
e 已 被 花 沉 的 输出 ， 即 已 经 当 作 了 后 面 交易 的 输入 ， 此 时 的 “Spend” 字 段 的 值 为 true, 
e 没 被 花费 的 输出 ， 即 还 没 被 作为 后 面 交 易 的 输入 ， 此 时 的 “Spend” 字 段 的 值 为 false。 


只 有 尚未 花费 的 输出 才 是 所 谓 的 UTXO 一 -一 未 花费 的 交易 输出 。 已 被 花费 的 交易 由 于 已 经 
支付 了 ， 因 此 不 是 UXTO, 


注意 区 分 概念 : UTXO 模型 不 等 于 UTXO 交易 ， 后 者 是 前 者 的 真子 集 。 
下 面 举例 进一步 前 述 UTXO 模型 的 特点 。 
假设 一 开始 的 时 候 A 拥 有 100 个 BTC，B 和 C 都 拥有 0 个 BTC， 如 图 2-23 所 示 。 


223 A、B、C 初始 拥有 的 BTC 


现在 A 向 B 转账 10 个 BTC。 于 是 , A 剩 下 90 个 BTC, 而 B 得 到 了 10 个 BTC，B 的 余额 是 
10。 此 时 的 交易 记录 如 图 2-24 所 示 ， 其 内 部 包含 一 入 一 出 的 记录 。 


交易 编号 : 1 交易 编号 : 2 


人 B: 10 BTC 


Pr ants A: 90 BTC 


2-04 ”交易 记录 
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A 的 100 个 BTC 不 会 凭空 产生 ， 它 也 是 由 其 他 输入 赋予 的 ， 例 如 比特 币 控 矿 所 得 。 在 交易 2 
中 ， 其 输入 部 分 为 交易 1 的 输出 ， 此 时 交易 1 的 输出 变 为 “Spend” 状 态 ， 交 易 1 中 的 输出 不 再 是 
UTXO 交易 ， 因 为 它 已 经 作为 了 交易 2 的 输入 。 交 易 2 使 用 输入 的 100 个 BTC， 分 别 输出 给 B 和 
A。B 获得 10 个 BTC，A 进行 目 己 的 找 零 操 作 , 给 了 B 的 10 个 BTC H, AER) F 90 个 。 此 时 在 
交易 2 中 的 B 和 A 的 输出 都 是 UTXO， 因 为 它们 还 没 被 “花费 ”。 

当 A 又 给 C 转账 6 个 BTC 和 给 B 转账 3 个 BTC， 交 易 记 录 如 图 2-25 Pros. 


交易 编号 : 1 交易 编号 : 2 


C: 6 BTC 


ARIETES B: 10 BTC 
B: 3 BTC 


A: 81 BTC 


100 BTC A: 90 BTC 


2-225 ”交易 记录 内 部 数据 组 成 的 模型 


此 时 ， 交 易 2 中 A 的 输出 将 不 再 是 UTXO， 因 为 它 成 为 了 交易 3 的 输入 ; 而 交易 2 中 B 的 依 
然 是 UTXO， 因 为 它 还 没 作为 其 他 交易 的 输入 。 

在 往 后 的 交易 中 便 一 直 按 照 上 面 的 记录 形式 来 记录 交易 的 输入 和 输出 。 

在 上 面 的 比特 币 例子 中 ，UTXO 模型 存在 几 种 情况 ， 但 不 变 的 是 其 记录 始终 由 输入 和 输出 组 
成 ， 在 此 之 外 还 多 了 一 个 手续 费 的 概念 。 一 般 地 ， 输 入 和 输出 拥有 下 面 的 几 种 组 合 情 况 : 

o 输入 的 条 数 比 输出 的 多 ， 输 出 的 条 数 不 只 一 条 。 

e 输出 的 条 数 比 输入 的 多 ， 输 入 的 条 数 不 只 一 条 。 

e 设 sum 是 累计 、 输 入 数值 为 inputs、 输 出 数值 为 ouputs、 手 续费 是 fee, 那么 比特 币 中 的 一 笔 

交易 恒 满足 : sum(inputs) - sum(ouputs) - fee = 0, 


比特 币 最 初 的 代 币 产生 是 从 挖 矿 中 获取 的 ， 后 续 的 代 币 因为 不 断 地 被 交易 而 被 分 配 到 各 个 地 
址 中 去 ， 根 据 UTXO 的 模型 ， 可 以 知道 : 


(1) 每 一 笔 交 易 的 输出 最 终 都 能 退 寻 一 个 一 开始 的 输入 。 
(2) 交易 的 最 初 输入 都 来 源 于 挖 矿 的 收益 地 址 ， 这 个 地 址 我 们 一 般 称 为 “CoinBase”。 


那么 如 何 统计 一 个 地 址 的 BTC 余额 呢 ? 其 实 就 是 统计 其 UTXO 集合 ,在 图 2-25 中 , B 的 BTC 
余额 相关 的 UTXO 分 别 在 交易 2 和 交易 3 中 ， 为 10+3=13 个 BTC. 
在 区 块 链 中 ， 不 同 的 交易 会 被 打包 到 不 同 的 区 块 中 去 。 这 意味 着 ， 当 我 们 需要 计算 某 个 地 址 
中 的 余额 时 ， 需 要 遍历 整个 网 络 中 所 有 与 该 地 址 相关 的 区 块 内 的 UTXO， 汇 总 后 便 是 它 的 余额 。 
UTXO 模型 明显 的 优点 : 
e UTXO 模型 是 无 状态 的 ， 只 要 交易 的 签名 合法 ,交易 额 正确 ， 那 和 勾当 交易 被 区 块 打 包 并 广播 
确认 后 就 会 被 直接 进行 存储 。 这 会 更 容易 应 对 并 发 转账 的 情况 ,因为 没有 类 似 序列 号 的 东西 ， 
当 一 个 地 址 拥有 很 多 UTXO 的 时 候 ， 可 以 同时 发 起 多 笔 交 易 。 
e 除 CoinBase 交易 外 ,交易 的 Input 始终 链接 在 某 个 UTXO 后 面 ， 交易 的 先后 顺序 和 依赖 关系 
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容易 被 验证 。 

UTXO 模型 明显 的 缺点 : 

e 无 法 实现 比较 复杂 的 逻辑 ， 可 编程 性 差 。 例 如 ， 以 太 坊 的 智能 合约 功能 就 无 法 通过 UTXO 模 
型 进行 拓展 实现 。 


e 性 能 问题 ， 例 如 计算 某 个 地 址 中 的 余额 时 ， 需 要 遍历 整个 网 络 中 的 全 部 相关 区 块 ， 找 到 该 地 
址 的 UTXO， 当 该 地 址 相关 的 交易 遍布 区 块 较 多 时 ， 时 间 复 杂 度 将 会 剧 增 ， 获 取 余 额 的 操作 
会 出 现 比较 慢 的 情况 。 


2.5.2 Trie 树 


1.Trie 树 的 定义 


Trie 树 又 称 字 典 树 ， 是 树 形 数据 结构 中 的 一 种 ， 同 缉 畴 的 还 有 完全 二 又 树 、 红 黑 树 等 ， 如 图 
2-26 所 示 。 


树 形 数据 结构 
mum 
226 树 形 数据 结构 的 分 类 


Trie 树 的 检索 体现 在 它 使 用 数据 茶 种 公共 前 绥 作 为 组 成 树 的 特点 ， 下 面 举 例 说 明 。 假 设 有 呐 
文 组 合 词 taa、tan、tc、in、inn、int， 这 些 词 就 是 我 们 的 数据 。 分 析 它 们 的 前 级 特点 : 首先 taa. tan. 
tc 这 3 个 单词 拥有 公共 的 开头 字母 t， 这 就 是 它们 的 公共 前 级 ， 归 为 一 类 ; 然后 in、inn、int 的 公 
共 开 头 字 母 是 1， 根 据 这 个 特点 ， 我 们 得 到 如 图 2-27 所 示 的 树 形 图 。 


d^ 


图 2-27 树 形 图 一 


RAAE, TE taa, tan, te 中 标 出 第 一 个 字母 t{ 后 ， 剩 下 的 分 别 是 aa、an、c。 可 以 看 到 ， 
aa 和 an 拥有 公共 的 前 级 字母 a， 因 此 模仿 上 和 耐 的 前 级 规则 可 以 继续 完成 树 形 图 ， 如 图 2-28 所 示 。 
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(a) Q) 
图 2-28 ” 树 形 图 二 


至 此 ， 从 树 项 节点 开始 目 上 而 下 看 ， 所 走 过 的 节点 值 连 起 来 就 是 taa. tan. tc. 25:76 15 BU AR 
i 字母 的 子 树 ， 最 终 整 个 Trie 的 前 级 树 如 图 2-29 所 示 。 


MEF, t, a, a 字母 o G) 


连 起 来 就 是 词 taa 
(a) (9 (n 

(a) (n) (n) (9) 
229 Trie 的 前 级 树 


如 果 例 子 中 在 起 始 的 时 候 多 出 一 个 和 其 他 节点 没有 公共 前 级 的 单词 , 例如 egg， 那 么 树 图 从 顶 
部 开始 将 分 成 3 个 分 文 ， 分 别 是 t、i、e， 而 不 是 两 个 。 

最 终 ， 各 个 单词 被 包含 在 Trie 树 中 。 一 棵 Trie 树 满 足下 面 的 特点 : 

e 不 一 定 是 二 又 树 。 

e 根 节点 不 包含 字符 ， 除 根 节点 以 外 每 个 节点 只 包含 一 个 字符 ， 注 意 是 字符 不 是 字符 串 。 

e 从 根 节 点 到 某 一 个 节点 ， 自 上 而 下 , 路 径 上 经 过 的 字符 连接 起 来 就 为 目的 节点 对 应 的 字符 串 。 

e 每 个 节点 的 所 有 子 节点 包含 的 字符 串 不 相同 。 

2. Trie 树 的 应 用 

为 什么 要 在 软件 应 用 中 采用 Trie 树 这 种 数据 结构 呢 ? 这 是 因为 Trie 树 在 针对 字符 串 搜 索 方 面 
有 很 好 的 性 能 。 

接着 Trie 树 的 例子 ， 如 果 我 们 要 查找 tan 这 个 单词 ， 可 以 按照 下 面 的 步骤 来 执行 。 


(D 首先 目 上 而 下 ， 先 得 找 字 母 t， 如 果 找 到 了 t， 那 么 不 是 t 的 分 文 束 不 需要 考虑 了 。 
(20 接 厦 查找 字母 a， 以 此 类 推 。 
G) 最 终 找 剩 下 的 字母 n。 


在 上 述 碍 找 过 程 中 ， 最 大 限度 地 减少 了 无 谓 字 符 的 比较 ， 但 由 于 Trie 树 的 非 根 节 点 存储 的 是 
每 一 个 字符 ， 导 致 Trie 树 会 消耗 大 量 的 内 存 ， 这 也 是 Trie 树 的 一 个 缺点 。 此 外 ，Trie 树 中 由 于 字 
从 串 之 间 没 有 公共 的 子 母 前 级 ， 因 此 树 的 层级 也 会 比较 高 ， 比 如 说 taa F ten, EIRE t TEREA 
共 的 ,那么 如 果 是 t->aa 和 t>cn 就 只 有 两 层 的 高 度 ,而 在 Tire 树 中 , 却 被 表示 为 了 t->a->a 和 t->c->n， 
拥有 3 层 的 高 度 。 
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2.5.3 Patricia Trie 树 


Patricia Trie 树 也 是 一 种 Trie 树 。 不 同 点 在 于 ， 它 是 Trie 树 的 升级 版 ， 在 Trie 树 的 基础 上 做 了 
优化 : 非 根 节点 可 以 存储 字符 串 ， 而 不 再 仅仅 是 字符 ， 节 省 了 衬 间 的 花 销 。 

仍然 以 上 一 节 的 Trie 树 为 例 ， 我 们 画 出 Patricia Trie 树 的 树 形 图 , 单词 是 taa、tan、tc、in、inn、 
int， 如 图 2-30 所 示 。 


© 
O0 
ca) (t) G 
(taa) (tan) (im) Cint) 
图 2-30 Patricia Trie 树 的 树 形 图 


这 里 我 们 给 出 abcd 和 aoip 两 个 字符 串 的 Patricia Trie PERI Trie 树 的 树 形 图 ， 如 图 2-31 所 示 。 
可 以 明显 地 看 到 ， 那 些 很 长 但 又 没有 公共 节点 的 字符 串 在 Patricia Trie 树 中 占用 的 空间 更 少 。 


字符 串 : abcd, aoip 


Patricia Trie 树 Trie 树 


图 2-31 Patricia Trie PRI Trie 树 的 树 形 图 


2.55.4 Hwnt (Merkle Tree? 


我 们 知道 ， 以 太 坊 区 块 Header 内 部 的 Root、TxHash、ReceiptHash 代表 的 都 是 以 太 坊 默 克 尔 
前 级 (MPT) 树 的 根 节点 的 喻 希 值 (Hash) 。 关 于 MPT 树 将 在 下 一 节 中 介绍 ， 本 节 我 们 先 来 认识 
上 默 殉 尔 树 以 及 这 三 个 蛤 希 相 关 的 概念 。 

默 殉 尔 树 又 被 称 为 哈 希 树 (Hash Tree) ， 它 满足 树 的 数据 结构 特点 ， 拥 有 下 面 的 特点 ， 也 就 
是 说 ， 默 殉 尔 树 必须 满足 下 面 的 条 件 。 

e 树 的 数据 结构 ， 第 见 的 是 二 叉 树 ， 但 也 可 以 是 多 叉 树 ， 它 具有 树 结构 的 全 部 特点 。 

e 基础 数据 不 是 固定 的 ,节点 所 存储 的 数据 值 是 具体 的 数据 值 经 过 哈 硕 运算 后 所 得 到 的 哈 硕 值 。 

e 哈 币 的 计算 是 从 下 往 上 逐 层 进行 的 ， 就 是 说 每 个 中 间 节 点 根据 相 邻 的 两 个 叶子 节点 组 合计 算 
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得 出 ， 根 节点 的 哈 布 值 根 据 其 左右 孩子 节点 组 合计 算得 出 。 
o 最 底层 的 节点 包含 基础 的 数据 。 


2-32 是 一 棵 二 又 树 形态 的 默 克 尔 树 。 


Root 根 
Value: hash 1234 
Node 节点 5 Node 节点 6 
Value: hash 12 Value: hash 34 
Node 节点 1 Node 节点 2 Node 节点 3 Node 节点 4 
Value: hash 1 Value: hash 2 Value: hash 3 Value: hash 4 


Node 1 的 数据 块 


2-32 二叉树 形态 的 默 殉 尔 树 


(1) B Fg EE, fgg ELT A Node 节点 1 的 数值 Value 是 hash 1, hash 1 是 由 Nodel 对 应 
的 数据 块 经 过 一 定 的 哈 希 算法 生成 的 , 其 他 的 最 底层 节点 也 有 对 应 的 数据 块 。 JH MOST NES v ZR P3 ES 
第 4 个 特点 。 

(2) Node 节点 5 是 Node 节点 1 和 Node 节点 2 的 父亲 节点 ， 那 么 Node 节点 5 的 哈 希 值 由 
Node 节 反 1 和 Node 节点 2 的 哈 希 值得 出 。 有 具体 父 节 点 的 值 如 何 计算 ， 并 没有 统一 的 方法 ， 可 以 
定义 某 一 种 算法 ， 只 要 满足 父 节 点 的 值 为 其 左右 时 子 节 点 的 值 经 过 一 定 计 算得 出 即 可 。 图 2-32 X 
用 了 字符 串 拼 接 的 计算 方式 : Value(5) = Value(1) + Value(2) = 12. JI 2608] VEA v ABE BJ SS 3 个 特点 。 

G) 由 于 生成 哈 希 值 的 原始 数据 几乎 都 是 字 节 流 ， 因 此 底层 数据 块 的 内 容 不 会 被 限制 ， 类 似 
于 区 块 涉 ， 拥 有 多 种 数据 类 型 ， 也 可 以 是 单独 的 一 个 字符 串 。 此 条 满足 默 克 尔 树 的 第 2 个 特点 。 

(4) 我 们 从 图 2-32 中 可 以 很 直观 地 看 出 ， 该 默 克 尔 树 就 是 数据 结构 中 的 二 又 树 模型 。 


1. SA se ZR B3 BST RA 


图 2-32 是 一 种 完全 二 又 树 的 形式 。 在 此 类 二 又 树 中 ， 当 一 个 新 的 数据 块 产生 的 哈 希 值 形 成 的 
新 的 节点 要 插入 树 中 时 , 如 果 所 要 被 插入 的 默 元 尔 树 抵 层 的 节点 已 经 是 满 叶 子 的 情况 , 它 会 按照 如 
图 2-33 所 示 的 形式 插入 。 

在 这 种 情况 下 ， 新 插入 的 叶子 节点 会 自动 在 不 同 的 层 数 生成 与 最 底层 新 插入 的 节点 所 拥有 相 
同 数 值 的 节点 ,图 2-33 新 插入 节点 为 A, 据 此 依次 生成 BC、D, 最 后 的 D 节点 是 新 的 根 节 点 (Root)。 

人 至此， 我 们 知道 ， 区 块 Header 内 部 的 Root、TxHash、ReceiptHash 这 3 个 值 的 含义 其 实 都 是 
默 殉 尔 树 的 根 ， 它 们 所 在 的 树 依 次 对 应 于 : 
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(1) 区 块 体内 的 账户 (Account) 对 象 数 组 。 在 打包 交易 中 该 对 象 数 组 会 时 刻 被 更 新 。 


(20 被 打包 进 当前 区 块 的 交易 《Transaction) 列表 数组 。 该 列表 数组 在 所 有 交易 打包 完 之 后 生成 。 
G) 区 块 内 的 所 有 交易 (Transaction) 完成 之 后 生成 的 一 个 Receipt 数组 。 


Node 


节点 
Value: hash 1234A 
Root t8 Node 节点 C 
Value: hash 1234 Value: hash A 
Node 节点 5 Node 节点 6 Node 节点 B 
Value: hash 12 Value: hash 34 Value: hash A 
Node 节点 1 Node 节点 2 Node 节点 3 Node 节点 4 Node 节点 A 
Value: hash 1 Value: hash 2 Value: hash 3 Value: hash 4 Value: hash A 


图 2-33 ” 满 叶 子 时 在 默 克 尔 树 中 插入 节点 后 的 变化 

2. 默 克 尔 树 数 据 验证 

默 殉 尔 树 的 作用 体现 得 最 多 的 地 方 就 是 它 可 被 用 于 数据 的 验证 。 在 以 太 坊 中 ， 默 元 尔 树 可 以 
用 来 验证 区 块 内 的 交易 〈Transaction) ， 因 为 以 太 坊 的 交易 是 被 矿工 打包 进 到 区 块 中 的 ， 所 以 一 个 
区 块 内 部 包含 有 很 多 笔 交 易 信 息 。 

根据 默 克 尔 树 父 节点 的 哈 希 值 与 其 叶 节 点 值 的 关系 ， 如 果 当 前 默 克 尔 树 的 底层 数据 块 是 交易 
数据 ， 那 么 往 上 的 节点 中 ， 其 所 包含 的 哈 希 值 都 是 由 交易 数据 生成 的 。 

根据 节点 中 哈 希 值 的 关联 关系 ， 可 以 对 某 笔 交 易 数 据 进行 验证 ， 如 图 2-34 Bran. 

假设 我 们 知道 了 交易 数据 1、Node 节点 1 和 Node 节点 6， 现 在 要 验证 交易 数据 2 是 否 在 当前 
的 默 克 尔 树 中 。 首 先 由 交易 数据 1 和 交易 数据 2 生成 Z 节点 的 哈 希 值 ， 然后 由 Node 节点 1 和 了 Z 节 
点 生成 立 节 点 的 哈 希 值 ， 最 后 由 立 节 点 和 Node 节点 6 生成 根 节点 X 的 哈 希 值 。 在 得 到 了 根 节点 
X 的 哈 希 值 之 后 ， 再 将 它 和 区 块头 部 中 的 TxHash 值 进行 比较 ， 判 断 它们 是 和 否 相 等 ， 如 果 相 等 ， 证 
明 交 易 数 据 2 存在 于 当前 区 块 的 交易 列表 中 ， 反 之 则 不 是 。 

默 殉 尔 树 交易 数据 的 验证 应 用 还 存在 于 点 对 点 的 视频 流 中 。 例 如 ， 将 一 部 完整 影片 的 数据 流 
拆 分 成 多 个 数据 块 ， 并 由 这 些 数 据 块 组 成 默 克 尔 树 。 当 用 户 下 载 影 片 时 ,就 能 根据 节点 值 来 对 应 下 
载 自 己 所 缺少 的 那 一 部 分 ， 在 数据 被 损坏 的 时 候 也 能 进行 下 载 修 复 ， 而 不 需要 重新 下 载 整 部 影片 。 


50 | 区 块 链 以 太 坊 DApp 开发 实战 


Y Node 节点 6 
Value: hash 34 
Node 节点 1 
Value: hash 1 Node 节点 3 Node 节点 4 
Value: hash 3 Value: hash 4 
交易 数据 1 待 验证 


2-34 BARBIE EGRE) UE 


25.5 ”以 太 坊 MPT fj 


MPT 树 的 全 称 是 “Merkle Patricia Trie”， 即 默 克 尔 前 绥 树 。 根 据 我 们 对 默 克 尔 树 和 前 绥 树 的 
介绍 ，MPT 树 可 以 认为 是 默 克 尔 树 和 前 级 树 的 结合 。 事 实 也 是 如 此 ，MPT HEELS; Zt T EX VG 
尔 树 和 前 级 树 的 特点 而 发 明 的 一 种 非常 重要 的 数据 结构 ， 因 此 它 具 备 了 炭 克 尔 树 和 前 级 树 的 特点 。 

MPT 树 中 的 节点 有 以 下 4 种 类 型 : 
扩展 节点 (Extension Node) ， 只 能 有 一 个 子 节点 。 

分 支 节点 (Branch Node) ， 可 以 有 多 个 节点 。 
叶子 节点 (Leaf Node) ， 没 有 子 节点 。 
空 节点 ， 空 字符 串 。 


1. 节 点 的 定义 及 说 明 
(1) 扩展 节点 


在 代码 中 ， 扩 展 节 点 含有 Key. Value 和 nodeFlag 字段 变量 ， 定 义 如 下 : 


type shortNode struct { 
Key  []byte 
Val node 
flags nodeFlag 


) 
(2) 叶子 节点 


和 扩展 节点 一 样 ， 也 包含 是 Key、Value 和 nodeFlag 字段 变量 ， 定 义 如 下 : 


type shortNode struct { 
Key  []byte 
Val node 
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flags nodeFlag 
} 


(3) DLHA 


分 文 节 点 的 内 容 是 一 个 长 度 为 17 的 数组 ， 其 中 ， 前 16 位 每 个 下 标的 值 是 十 六 进 制 的 0~f、 十 
进 制 的 0~1$5， 它 们 每 位 可 能 指 加 一 个 孩子 分 支 ， 且 人 允许 不 做 任何 指向 ， 在 最 后 的 第 17 位 是 它 自 己 
的 Value. KE, —^ 2) 3€ B ExBUfA T eH 16 个 。 代 码 中 的 定义 是 : 
type fullNode struct { 
Children [17]node 


flags nodeFlag 
} 


这 3 KT n BU 2 4 n] 22 25 R] 3-35. 


扩展 节点 叶子 节点 
分 支 节点 


"IBBHBBBBRBOHUUOHOHEBHKEE 


2-35. MPT 树 中 的 3 类 主要 叶子 节点 的 结构 


2. PATRATE 


CD Key 只 在 扩展 节点 和 叶子 节点 中 存在 。 请 注意 , 分 文 节 点 没有 Key. Key 就 是 [Key,Value] 

“ 键 - 值 对 ”数据 结构 中 的 “ 键 ”。 在 以 太 坊 中 ， 不 同 的 存储 阶段 ，Key 的 值 是 不 同 的 ， 有 如 下 一 

e Raw 编码 。 这 种 编码 方式 的 Key 是 MPT 对 外 提供 接口 的 默认 编码 方式 。 例 如 ， 一 个 Key 为 
“cat”， 则 其 Raw 编码 就 是 ['c', 'a', t HRR ASCI 编码 的 表示 方式 就 是 [63, 61, 74]. 

e Hex 十 六 进 制 编码 。 这 种 是 MPT 对 内 存 中 树 节点 的 Key 进行 的 编码 方式 ， 当 数据 项 被 插入 
到 MPT 树 中 时 ，Raw 编码 被 转换 成 Hex 编码 。 其 诞生 的 原因 是 为 了 减少 分 支 节 点 孩子 的 个 
数 ， 由 分 支 节 点 的 定义 和 对 应 的 示范 图 可 以 看 出 , 分支 节点 最 多 有 16 个 孩子 节点 。 叶 致 最 多 
只 有 16 个 孩子 节点 的 原因 ， 就 是 使 用 了 这 种 编码 方式 ， 不 然 的 话 会 由 于 原来 Key 的 8 位 范 
围 取 值 是 [0-(2^7-1)]， 即 [0-127]， 意 味 着 有 128 个 位 ， 从 而 对 应 到 128 个 孩子 节点 这 么 多 。 为 
了 减少 可 对 应 的 孩子 节点 数 ， 以 太 坊 将 原 Key 的 高 低 共 8 位 分 拆 成 两 个 字 节 ， 以 4 位 进行 存 
储 ， 而 4 位 在 十 六 进 制 中 ， 最 大 能 表示 的 是 f， 即 其 范围 为 [0-， 从 而 减 小 了 每 个 分 支 凶 点 的 
容量 ， 但 是 在 一 定 程度 上 增加 了 树 的 高 度 。 

从 Raw 编码 向 Hex 编码 的 转换 规则 是 : 

> 将 Raw 编码 的 每 个 字符 根据 高 4 位 、 低 4 位 拆 成 两 个 字 节 。 

> 若 该 Key 对 应 节点 存储 的 是 真实 的 数据 项 内 容 (该 节点 是 叶子 节点 ) ， 则 在 末 位 添加 一 
个 ASCII 值 为 16 的 字符 作为 终止 标志 符 。 


52 | 


区 块 链 以 太 坊 DApp 开发 实战 


> 若 该 Key 对 应 的 节点 存储 的 是 另外 一 个 节点 的 哈 硕 索引 (该 节点 是 扩展 节点 ) ， 则 不 加 
任何 字符 。 
> 例如 ， 某 叶子 节点 的 Key A “cat” , 其 Raw 编码 就 是 ["c,'av 风 ]， 转 换 成 ASCII 表示 方式 
就 是 [63, 61, 74]， 其 Hex 编码 为 : 
[0011,1111,0011,1101,0100,1010,0x10] => [3, f, 3, d, 4, a, 0x10] 一 > [3,15,3,13,4,10,16] 
HP 编码 ， 全 称 为 “Hex-Prefix 编码 ”， 即 十 六 进 制 前 级 编码 ， 是 MPT 中 的 树 节 点 被 持久 化 
存储 到 数据 库 层 面 时 Key 被 编码 的 形式 。 当 树 节 点 被 加 载 到 内 存 中 时 ，HP 编码 会 被 转换 成 
Hex 编码 ， 对 应 从 Hex 编码 到 HP 编码 ， 刚 好 是 一 个 对 称 的 过 程 。 
HP 编码 的 规则 如 下 : 
D 若 输 入 Key 结尾 为 0x10， 则 去 掉 这 个 终止 符 。 
Q Key 之 前 补 一 个 四 元 组 ， 从 右 往 左 ， 这 个 四 元 组 第 0 位 作为 区 分 奇偶 信息 ， 若 Key 长 度 为 
奇数 则 该 位 为 1， 若 长 度 为 偶数 则 该 位 为 0。 第 1 位 区 分 节点 类 型 ,叶子 节点 类 型 是 1， 其 他 是 0。 
@ 如 果 输 入 Key 的 长 度 是 偶数 ， 就 再 添加 一 个 四 元 组 0x0000 在 第 加 点 的 四 元 组 之 后 。 
© 将 原来 的 Key 内 容 压 缩 ， 共 8 位， 以 高 4 位 低 4 位 进行 合并 输出 。 例 如 ， 菜 叶子 节点 的 
Key 为 “cat”， 它 的 Hex 编码 是 [3,15,3,13,4,10,16]， 根 据 第 @ 点 ， 因 为 16 对 应 的 十 六 进 制 表 
示 就 是 0x10， 所 以 去 掉 它 ， 此 时 变 为 [3,15,3,13,4,10]， 共 6 个 数值 ， 所 以 长 度 是 偶数 。 根据 第 
@ 点 ，Key 之 前 补 全 四 元 组 0x0， 此 时 变 为 [0x0000,3,15,3,13,4,10]， 因 为 是 节点 类 型 ， 所 以 从 
右 往 左 ， 第 0 位 为 0， 第 一 位 是 1， 变 为 [0x0010,3,15,3,13,4,10]。 根 据 第 @ 点 ，Key 的 长 度 是 
偶数 ， 则 再 添加 一 个 四 元 组 0x0 在 之 前 的 四 元 组 之 后 ， 变 为 [0x00100000,3,15,3,13,4,10]。 根据 
最 后 一 点 ， 压 缩合 并 ， 变 为 [32, 63, 61, 74]，32 就 是 二 进 制 00100000 的 十 进 制 数 : 2^5=32.。 
此 时 再 转 为 Hex 编码 就 是 [2,0,3,15,3,13,4,10]。 


因为 在 HP 编码 情况 下 的 Key 加 入 了 Prefix 前 级 ， 所 以 在 细 分 Key 内 容 的 时 候 应 该 多 出 一 个 


前 级 码 ， 


如 图 2-36 押 示 。 前 绥 的 好 处 之 一 是 能 够 标识 这 个 节点 的 类 型 。 


| T. 


2-36 HP 编码 时 的 扩展 节点 /叶子 节点 


TE BRI RH] Key 为 “cat” 的 例子 中 ， 通 过 HP 编码 计算 出 的 [2,0,3,15,3,13,4,10]， 其 
Key-prefix 就 是 2，Key-end 是 0,3,15,3,13,4,10。 


(2) Value 是 用 来 存储 节点 数值 的 ， 不同 的 节操 类 型 ，Value 对 应 的 值 也 不 同 ， 主 要 有 下 面 几 


种 情况 : 


vH. Value 存储 的 是 一 个 数据 项 的 内 容 , 例如 [name, LinGuanHong], Key Æ name, Value 
是 LinGuanHong， 在 代码 中 对 应 于 ValueNode。 

扩展 节点 。Value 存储 的 是 其 孩子 节点 在 数据 库 中 存储 的 哈 布 值 ， 可 以 通过 该 哈 大 链接 到 其 
他 节点 。 在 代码 中 ， 对 应 hashNode 类 型 。 

TAPS. Value 存储 的 是 在 当前 分 支 节点 结束 时 节点 的 数据 值 , 在 代码 中 对 应 于 ValueNode。 
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比如 : Key 有 abc、abd、ab， 根 据 前 缓 树 的 特点 开始 构建 树 ， 如 图 2-37 所 示 。 因 为 3 个 Key 
拥有 公共 的 前 级 ab， 其 中 abc 和 abd 还 多 出 一 个 字符 ， 可 以 对 应 在 分 支 节 点 中 ，ab 没有 多 出 
的 字符 ， 它 刚好 在 分 支 节点 中 结束 ， 此 时 分 支 节点 的 Value 存储 的 就 是 民 ey=ab 节点 的 值 。 当 
没有 节点 在 分 支 节点 中 结束 时 ， 那 么 分 支 节 点 的 Value 没有 数据 存储 。 
key: abc ,abd, ab 
value: 5 , 8 , 11 


| ab | value | 扩展 节点 value 为 hashNode 


0|1|12|13|14|15|6|7|18|9|a|blc|d|e|f|value | 分 支 节点 


value 是 valueNode 值 是 11 


两 个 叶子 节点 ，value 都 是 valueNode 
图 2-37 分 支 节点 Value 有 值 的 情况 


(3) nodeFlag 是 分 文 节 点 、 扩 展 节点 和 叶子 节点 在 代码 结构 体 中 附带 的 字段 ， 主 要 用 于 记录 
一 些 辅助 数据 ， 其 代码 中 的 定义 如 下 : 


type nodeFlag struct { 
hash hashNode // cached hash of the node (may be nil) 
gen  uintl16  // cache generation counter 
dirty bool // whether the node has changes that must be written to the 


database 
} 


说 明 : 

e 节点 哈 希 hash。 若 该 字段 不 为 空 ， 则 当 需 要 进行 哈 希 计算 时 ， 可 以 跳 过 计算 过 程 而 直接 使 用 
上 次 计算 的 结果 ( 当 节 点 变 脏 时 ， 该 字段 被 置 空 ) 。 
及 标志 dirty。 当 一 个 节点 被 修改 时 ， 该 标志 位 被 置 为 1。 
诞生 标志 gen。 当 该 节点 第 一 次 被 载 入 内 存 中 (或 被 修改 时 ) ， 会 被 赋予 一 个 计数 值 作为 诈 
生 标 志 ， 该 标志 会 被 作为 驱除 节点 的 依据 一 一 清除 内 存 中 “ 太 老 ”的 未 被 修改 的 节点 ， 防 止 
占用 的 内 存 空 间 过 多 。 


2.5.6 MPT 树 市 点 存储 到 数据 库 


MPT 树 节 点 存储 到 数据 库 ， 又 称 节 点 的 持久 化 ， 这 个 过 程 需 要 计算 出 各 个 节点 对 应 的 RLP 编 
人 码 数 据 及 节 扣 的 蛤 布 值 ， 其 最 终 存储 在 “ 键 - 值 对 ”<k,v> 数 据 库 中 的 格式 是 : [T nin o E IRE 
RLP 编码 ]。 要 注意 区 分 ， 这 里 持久 化 的 哈 希 值 不 是 Key 的 蛤 希 值 ， 而 是 节点 RLP 编码 的 哈 希 值 。 
此 外 ， 持 久 化 的 计算 过 程 是 一 个 递归 过 程 ， 意 味 厦 这 个 计算 是 从 MPT 树 的 底部 开始 从 下 往 上 进行 
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的 。 持 久 化 的 步骤 是 : 
(OD 使 用 “RLP” 将 节点 的 数据 进行 序列 化 编码 。 
e 对 叶子 /扩展 节点 来 说 ， 该 节点 的 RLP 编码 就 是 对 其 Key 和 Value 数据 一 起 进行 编码 。 即 
rlp(Key + Value). 
e 对 于 分 支 节 点 ， 该 节点 的 RLP 编码 是 对 其 孩子 列表 对 应 的 哈 布 值 一 起 进行 RLP 编码 ， 如 果 
此 时 的 分 支 节点 的 Value 对 应 的 是 valueNode， 即 有 数值 ， 那 么 RLP 编码 也 要 加 入 Value, Pp 
rlp(childNode's hash + Value). 


(QD 在 每 个 节点 计算 出 各 目的 RLP 编码 后 ， 再 根据 RLP 编码 计算 出 节点 的 哈 希 值 。 使 用 的 
是 SHA256 算法 计算 ， 即 hash = sha256(rlp 数据 )。 
(3) 对 应 <k,v> 数 据 库 中 k=hash、v=rlp 编码 ， 进 行 节 点 的 持久 化 存储 。 
持久 化 对 应 源码 中 的 操作 代码 (代码 文件 位 置 是 trie/hasher.go) 如 下 所 示 : 


func (h *hasher) store(n node, db *Database, force bool) (node, error) { 


// rlp.Encode 将 节点 node 数据 进行 rlp 编码 ， 存 储 于 tmp 内 ， 其 中 Key 和 Value 都 在 内 部 
if err := rlp.Encode(&h.tmp, n); err != nil { 

panic("encode error: " + err.Error()) 
} 
if hash == nil { 

hash = h.makeHashNode(h.tmp) // 使 用 sha256 X} rip 数据 进行 哈 希 计算 
} 
rf db != nit T 

db.lock.Dbockiíi) 

hash := common.BytesToHash (hash) 

db.insert(hash, h.tmp) // 存储 


2.5.7 组建 一 棵 MPT 树 


根据 对 MPT 树 的 介绍 ， 本 节 我 们 从 插入 第 一 个 节点 开始 组 建 一 棵 MPT 树 ， 来 对 MPT 树 做 一 
个 整体 的 认识 。 因 为 节点 中 的 Key 在 不 同 阶段 对 应 的 编码 形式 并 不 相同 ， 为 了 体现 出 “Hex-Prefix 
编码 ”， 我 们 下 面 在 构建 的 时 候 将 HP 编码 加 入 到 里 面 去 。 注 意 ， 在 实际 情况 中 ，HP 编码 只 有 在 
节点 持久 化 时 才 会 用 到 ， 并 出 现 “Key-Prefix”， 而 在 内 存 层面 的 MPT 树 ， 节 点 的 Key 是 “Hex 
编码 ”格式 ， 此 时 还 没有 “Key-Prefix”。 

用 于 构建 MPT 树 的 节点 如 图 2-38 所 示 。 

首先 设 根 节点 为 Roote 在 构建 的 过 程 中 , 一般 Root 还 没有 生成 ， 只 有 在 整 棵 树 都 构建 完成 后 
才 会 从 底部 往 上 开始 计算 哈 硕 值 ， 最 终 算出 根 Root KRAE 

插入 第 一 个 节点 <a711355,45> 的 时 候 ， 树 如 图 2-39 所 示 。 
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已 经 转 为 了 16 进 制 的 key 数值 


a711355 45.0 


a77d337 


a719365 


a77d397 


2-38 用 于 构建 MPT 树 的 节点 数据 2-39 ”插入 节点 <a711355,45> 的 树 


接着 插入 第 二 个 节点 <a77d337,1>。 因为 a77d337 和 a711355 拥有 公共 的 前 级 a7， 所 以 a7 变 为 
一 个 扩展 节点 ， 其 value 存储 的 是 分 文 节 点 的 哈 硕 值 ， 剩 下 的 是 两 个 叶子 节点 ， 树 如 图 2-40 所 示 。 


图 2-40 插入 节点 <a77d337,1> 之 后 的 树 


接 独 插入 第 三 个 节点 <a7f9365,1.1>。 因 为 这 个 节点 和 前 两 个 节点 都 拥有 前 级 a7， 所 以 它 将 会 
是 分 文 节 点 中 的 一 员 ， 插 入 第 三 个 节点 之 后 的 树 如 图 2-41 所 示 。 


叶子 节点 叶子 节点 叶子 节点 


2-41 插入 节点 <a7f9365,1.1> 之 后 的 树 


最 后 插入 节点 <a77d397,0.12>。 因 为 a77d397 和 第 二 个 节点 的 key (a77d337) 在 分 文 节点 之 后 
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还 存在 d3 的 公共 前 级 ， 因 此 在 它们 之 间 要 添加 新 的 以 key 为 d3 的 扩展 节点 ， 然 后 剩 下 的 37 与 97 
还 要 添加 一 个 分 支 节点 。 为 什么 是 分 支 节点 昵 ?” 因 为 扩展 节点 只 能 有 一 个 孩子 节点 , 而 且 我 们 现在 
还 剩 下 37 与 97， 所 以 为 了 容纳 两 个 节点 只 能 使 用 分 文 节 点 。 最 终 的 树 如 网 2-42 所 示 。 


叶子 节点 


2-42 插入 节点 <a77d397.0.12> 之 后 的 树 


图 2-42 是 最 终 构 建 好 的 MPT 树 。 现 在 我 们 继续 根据 “Hex-Prefix 编 权 ”计算 出 扩展 节点 和 叶 
T BB) "Key-Prefix" (E. fd HP 编码 规则 ， 最 终 得 到 的 树 如 图 2-43 所 示 。 


+ pae] 
叶子 节点 叶子 节点 


扩展 节点 


-13|-|19|1-|vaue| asus 
UL 


叶子 节点 叶子 节点 


CUCHECDBNCDEHEIES 


343 ”最 终 构建 完成 的 MPT 树 及 其 各 节点 的 数据 情况 
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2.5.8 MPT 树 如 何 体现 默 克 尔 树 的 验证 特点 


因为 MPT 树 拥 有 默 殉 尔 树 的 特点 ， 所 以 MPT 树 也 具备 默 克 尔 树 依 徘 节 点 哈 希 值 来 校 验 数据 
合法 性 的 特点 。 那 么 MPT 树 是 怎样 利用 节点 的 哈 布 值 来 实现 数据 校 验 的 呢 ? 

由 MPT 树 节点 持久 化 的 特点 可 知 ， 持 久 化 时 每 个 节点 会 生成 对 应 的 哈 希 值 ， 而 MPT 树 校 验 
过 程 所 使 用 的 节点 哈 希 值 就 是 持久 化 时 使 用 RLP 数据 生成 的 哈 希 值 。 回 顾 持 久 化 的 步 又， 节点 生 
成 哈 希 值 的 顺序 是 从 底部 开始 的 , 父 节 点 蛤 希 值 的 生成 依赖 孩子 节点 的 哈 希 值 , 孩子 节点 的 哈 希 值 
由 其 自 喘 的 Key 和 Value 生成 ， 最 后 生成 树 的 根 节点 的 哈 希 值 。 

KE, MPT 树 在 验证 某 个 节点 的 合法 性 时 也 符合 默 克 尔 树 从 底部 开始 , 逐 级 往 上 的 验证 过 程 ， 
逐步 生成 父 节点 的 哈 希 值 ， 最 后 生成 根 节点 的 哈 希 值 ， 然 后 和 Root 对 比 ， 判 断 它 们 是 否 相 等 ， 是 
则 为 合法 节点 ， 奋 则 就 是 非法 节点 。 


2.5.9 以 太 坊 钱包 地 址 存储 余额 的 方式 


以 太 坊 区 块 Header 结构 体 中 “Root” 变 量 的 真实 含义 是 ， 以 太 坊 区 块 账 户 MPT 树 根 节 点 的 哈 
WE, 区 块 账户 MPT 树 中 每 个 叶子 节点 的 Key 中 存放 的 是 以 太 坊 钱包 的 地 址 值 , 叶子 节点 的 Value 
对 应 的 是 以 太 坊 的 状态 对 象 stateObject。 而 状态 对 象 stateObject 中 又 含有 账户 Account 对 象 ， 在 
Account 对 象 中 有 一 个 指针 变量 Balance， 指 问 以 太 坊 存放 余额 的 内 存 地 址 ， 这 也 是 以 太 坊 的 账户 

(Account) 模型 。 


stateObject 对 象 和 Account 对 象 在 代码 中 的 定义 分 别 如 下 : 


type stateObject struct { 
address common.Address 
addrHash common.Hash // 钱包 地 址 的 哈 希 变量 形态 
data Account // Account 对 象 
db *StateDB 
dbErr error 
trie Trie // 首次 访问 ，stateobject 还 没有 被 纳入 树 节点 中 ， 它 会 是 空 值 
code // 只 有 当 该 账号 是 智能 合约 账号 时 ， 它 才 有 值 ， 对 应 的 是 合约 的 bytecode 


} 

type Account struct { 
Nonce uint64 
Balance *big.Int 


Root common.Hash // 树 根 的 哈 希 值 
CodeHash []byte 
} 


说 明 : 

e Nonce， 如 果 账 户 是 用 户 钱包 账户 ， Nonce 代表 的 是 该 账户 发 出 当前 交易 时 的 交易 序列 号 ; 如 
果 账 户 是 智能 合约 账户 ，Nonce 代表 的 是 此 账户 创建 的 合约 序号 。 

e Balance， 该 账户 目前 存放 以 太 币 余额 的 内 存 地 址 ， 请 注意 是 以 太 币 。 

e Root， 当 前 MPT 树 的 根 节 点 的 哈 希 值 。 
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© CodeHash， 如 果 账 户 是 用 户 钱包 账户 ， 该 值 为 空 ， 如 果 是 智能 合约 账户 ， 该 值 对 应 于 当初 发 
布 智能 合约 代码 的 十 六 进 制 哈 布 值 。 


因为 每 个 区 块 都 对 应 一 棵 账户 MPT 树 ， 就 区 块 而 言 ， 它 的 账户 MPT 树 中 的 账户 数据 都 来 源 
于 被 当前 区 块 打 包 了 的 交易 中 ， 因 为 每 笔 交 易 中 都 存在 看 账户 与 账户 之 间 的 代 币 Token)〉 资 产 转 
移 记 录 ， 区 块 打包 了 茶 笔 交 易 ， 便 会 提取 该 交易 中 的 账户 资产 信息 作为 账户 MPT PII T nid 
入 到 树 中 。 


2.5.10 ”余额 查询 的 区 块 隔离 性 


我 们 知道 ， 账 户 的 MPT 树 的 叶子 节点 依赖 于 当前 区 块 打包 了 的 交易 数组 ， 换 句 话说 ， 账 户 
MPT 树 记 录 的 账户 信息 是 基于 区 块 的 。 由 于 以 太 坊 节点 同步 的 有 效 区 块 来 源 于 公有 区 块 链 ， 因 此 
节点 之 间 存 在 同步 区 块 的 快慢 情况 ， 这 种 情况 常会 造成 余额 查询 出 错 。 

下 面 我 们 通过 一 个 例子 来 加 以 说 明 。 

假设 公 链 的 最 新 区 块 高 度 是 100， 现 在 有 两 个 以 太 坊 节点 A 和 B， 节 点 A 同步 区 块 到 了 高 度 
98， 它 把 高 度 98 打包 了 的 交易 中 的 账户 信息 逐个 更 新 到 <k,v> 数 据 库 中 ， 而 节点 B 同步 区 块 到 了 
高 度 100， 节 点 B 也 保存 好 了 账户 信息 。 

此 时 ， 假 如 一 个 以 太 坊 节点 C 共 有 8 个 ETH， 且 在 之 前 发 起 了 两 笔 交 易 ， 第 一 笔 交 易 转 账 出 
去 了 3 个 ETH， 第 二 笔 交 易 转 账 出 去 了 2 个 ETH， 第 一 笔 交 易 被 区 块 98 FAT, 第 二 笔 交 易 被 区 
Hk 100 打包 了 。 此 时 节点 D 调用 以 太 坊 的 RPC 接口 查询 节点 C 的 以 太 坊 ETH 余额 ， 被 查询 到 的 
节点 刚好 是 B, 那么 节点 B 返回 的 将 会 是 (8-3=5 ) 的 结果 , 而 事实 上 节点 C 的 真实 余额 是 (8-3-2=3 ) 
Ñ ETH. 


2.5.11 余额 的 查询 顺序 


虽然 账户 数据 会 被 持久 化 到 <k,v> 数 据 库 中 ， 但 是 在 进行 账户 余额 查询 时 并 不 是 直接 到 <k,v> 
数据 库 中 查找 ， 因 为 账户 MPT 树 持久 化 的 “ 键 - 值 对 ”是 一 个 已 量 的 <k,v> 数 据 集 ， 直 接 查 询 需 要 
很 长 时 间 ， 为 加 快 查询 速度 ， 以 太 坊 在 钱包 地 址 中 代 币 “Token) 余额 查询 上 设置 了 三 级 缓存 机 制 。 

我 们 再 来 看 stateObject 结构 体 ， 其 中 有 一 个 StateDB 类 型 的 db 对 象 指 针 , 该 db 指针 对 象 就 存 
储 了 基于 内 存 的 缓存 Map。stateObject 和 StateDB 在 代码 中 的 定义 如 下 : 


type stateObject struct { 
address common .Address 
addrHash common.Hash // 钱包 地 址 的 哈 希 变量 形态 
data Account // Account 对 象 
db *StateDB 


} 
type StateDB struct { 
db Database //leveldb 对 象 
trie Trie // Trie 树 的 第 二 级 缓存 
stateObjects map[common.Address]*stateObject // 第 一 级 内 存 缓存 
stateObjectsDirty map [common .Address]struct{} 
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} 
余额 的 查找 顺序 是 : 


(1) 第 一 级 查找 基于 内 存 中 的 stateObjects 对 象 ， 这 里 保留 了 近期 活跃 的 账号 信息 。 
(2) 第 二 级 查找 基于 内 存 中 的 trie 树 。 
(3) 第 三 级 查找 基于 leveldb， 即 <k.v> 数 据 库 层 。 


第 一 级 和 第 二 级 得 找 都 是 基于 内 存 的 , 第 二 级 的 Trie 体现 在 代码 上 是 一 个 接口 , 在 stateObject 
H, trie 变量 最 终 是 一 棵 MPT 树 ， 它 被 用 于 在 检验 某 一 个 钱包 地 址 Caddress) 的 stateObject 数据 
是 否 真 的 存在 于 菏 个 区 块 中 , 其 验证 方式 就 是 默 克 尔 树 的 数据 校 验方 式 , 这 种 设置 优化 了 查找 的 整 
体 时 间 复 杂 度 。 


2.5.12. UTXO 模型 和 Account 模型 的 对 比 


根据 前 文 对 比特 币 UTXO 模型 和 以 太 坊 Account 模型 的 介绍 ， 可 以 得 出 以 下 几 点 结论 : 


CD 在 计算 方面 ，UTXO 本 身 并 没有 过 多 的 复杂 计算 ， 且 在 链 上 的 计算 也 不 多 , 由 于 Account 
模型 是 图 灵 完 备 的 ， 文 持 智 能 合约 , 它 的 运算 大 部 分 在 链 上 ， 计 算 相 对 来 说 比较 复杂 。 因 为 智能 合 
约 部 分 对 应 的 是 从 Solidity 编程 到 编译 的 整个 过 程 ， 通 过 代码 能 够 实现 一 切 可 计算 问题 ， 所 以 
Account 模型 比 UTXO 模型 更 具备 可 编程 性 。 

(2) 在 并 发 发 起 交易 方面 ，UTXO 模型 支持 并 发 ， 因 为 它 不 受 交 易 编 号 顺序 的 限制 ， 所 以 可 
以 无 须 考虑 顺序 而 以 批量 方式 发 起 交易 。Account 模型 因为 存在 Nonce 交易 序列 号 ， 所 以 它 严谨 地 
要 求 每 笔 交 易 的 Nonce 必须 是 递增 的 ， 也 就 是 说 ， 它 的 每 笔 交 易 都 存在 强 关 联 性 。 

《3) 在 交易 重 放 方 面 , UTXO 模型 和 Account 模型 都 具备 抵抗 交易 重 发 情况 的 功能 。 在 UTXO 
模型 中 ， 因 为 每 次 交易 的 输入 (Inputs ) 都 和 输出 COutputs). 都 存在 从 入 到 出 的 关系 ， 如 果 一 个 相 
同 的 交易 被 重新 发 起 , 那么 它 所 对 应 的 输入 在 第 一 次 的 时 候 就 已 经 被 消费 了 , 便 会 导致 当前 的 交易 
失败 ， 可 以 说 是 自身 就 带 有 抵抗 交易 重复 的 特点 。 相 对 来 说 ，Account 模型 的 做 法 是 采用 强 顺 序 性 
的 交易 序列 号 Nonce 来 抵抗 交易 重 发 问题 。 

(40 在 存储 方面 ， 在 UTXO 模型 中 的 交易 记录 存储 在 链 上 的 区 块 中 ， 这 样 时 间 一 长 ， 比 特 币 
的 公 链 上 ， 区 块 整体 数据 量 会 变 得 非常 庞大 。 而 Account 模型 存储 在 链 上 的 只 有 MPT 树 的 根 节 点 
的 哈 希 值 ， 实 际 的 节点 数据 都 持久 地 存放 在 每 个 节点 本 地 的 <kv> 数 据 库 中 。 

(5) 在 余额 得 询 效率 方面 ， 因 为 UTXO 模型 并 没有 直接 存储 某 个 钱包 地 址 的 资产 余额 ， 而 是 
通过 多 个 输入 输出 交易 来 记录 资产 的 变化 ,从 而 导致 在 得 询 钱包 地 址 中 的 资产 余额 时 须 先 获取 到 所 
有 相关 的 UTXO 交易 记录 的 列表 ， 再 汇总 统计 。 而 Account 模型 使 用 了 三 级 缓存 的 形式 ， 即 使 组 
存 中 没有 记录 ， 其 最 终 也 会 到 <k,v> 数 据 库 中 直接 查询 余额 信息 。 


综 上 所 述 ，Account 模型 具备 可 编程 性 和 灵活 性 ， 而 UTXO 则 在 简单 业务 和 跨 链 上 ， 有 其 独 
到 和 开创 性 的 优势 。 
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2.6 ”以 太 坊 的 版 本 效 芝 


以 太 坊 的 发 展 主 要 体现 在 版 本 的 演变 上 ， 类 似 于 一 个 常规 软件 的 升级 流程 ， 它 的 升级 方式 是 
先 增加 节点 的 代码 再 编 详 成 对 应 版 本 的 节 扣 程序 ， 然 后 发 布 ， 让 其 他 亨 点 同步 更 新 升级 。 

以 太 坊 每 次 升级 者 是 为 改善 以 太 坊 网 络 ， 或 修复 问题 ， 或 增强 以 太 坊 网 络 的 性 能 ， 每 个 版 本 
都 有 其 各 目的 特点 。 


2.6.1 以 太 坊 与 POW 共识 机 制 


以 太 坊 源码 在 发 展 的 过 程 中 ， 其 在 不 同 阶段 所 使 用 的 共识 算法 并 不 相同 ， 下 面 分 版 本 进行 说 
HH. 

(1) Frontier CHO 。 这 个 版 本 是 以 太 坊 的 基础 ， 此 时 的 以 太 坊 具备 了 挖 矿 、 交 易 及 智能 合 
约 功 能 模块 ， 但 是 没有 供 普通 用 户 使 用 的 图 形 化 界面 ， 仅 适合 开发 者 使 用 ， 所 使 用 的 共识 算法 是 
“Pow” o 

(2) Homestead (Xid) 。 这 个 版 本 的 以 太 坊 网 络 变 得 更 加 稳定 ， 且 具备 了 图 形 界 和 面 的 钱包 
软件 ， 所 使 用 的 共识 算法 还 是 “PoW”。 

(3) Metropolis (大 都 会 )。 分 为 下 和 面 两 个 子 版 本 : 

e 拜占庭。 发 布 了 集合 钱包 功能 以 及 合约 发 布 等 丰富 功能 的 图 形 化 界面 软件 “Mist” ， 同 时 也 
引入 了 很 多 新 的 技术 ， 例 如 零 知 识 证 明和 抽象 账号 等 ， 使 用 的 共识 算法 仍然 是 “PoW”。 截 
至 2018 年 12 月 14 日 ， 以 太 坊 最 新 发 布 的 版 本 是 “Metropolis 大 都 会 ”的 “和 拜占庭 ”。 

e 有 君 士 坦 丁 堡 。 本 计划 使 用 混合 共识 算法 “PoW+PoS”， 但 最 终 依然 是 “PoW”， 为 “宁静 ” 
做 铺 热 。 


(4) Serenity (宁静 )。 该 版 本 将 把 以 太 坊 的 共识 算法 全 部 换 成 基于 “PoS ”的 变种 算法 “Casper 
投注 共识 ”， 它 属于 “PoS” 系 列 。 

由 上 可 知 ， 在 以 太 坊 发 展 的 过 程 中 ， 其 共识 算法 在 不 同 的 阶段 经 历 了 从 “PoW ”共识 、 
“PoW+PoS” 共 识 到 “PoS” 共 识 ， 可 以 说 ， 以 太 坊 的 共识 算法 是 从 “PoW” 开 始 的 。 


2.6.2 看 士 坦 丁 堡 


作为 以 太 坊 大 都 会 版 本 的 子 版 本 ， 君 士 坦 丁 堡 的 升级 已 经 确定 在 主 网 区 块 高 度 7080000 的 时 
候 激 活 ， 北 京 时 间 大 致 在 2019 年 1 H 14 日 到 18 日 之 间 。 

因为 本 次 升级 获得 了 所 有 公 网 节点 的 认同 ， 意 味 着 不 会 出 现 分 叉 币 ， 同 时 也 不 会 影响 到 已 有 
以 太 坊 地 址 的 ETH 代 币 。 作 为 以 太 坊 的 公 网 节点 需要 准时 同步 升级 节点 的 程序 ， 以 确保 节点 在 新 
的 链 上 继续 挖 矿 生 产 区 块 。 

下 面 我 们 来 介绍 君 士 坦 丁 堡 版 本 的 一 些 主要 特性 : 


(OD 共识 机 制 ， 依 然 是 “PoW”。 
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(2) 加 入 了 下 面 的 EIP (Ethereum Improvement Proposal) ，EIP 中 文 全 称 是 以 太 坊 改进 建议 。 


e EIPl45: 出 自 以 太 坊 开 发 人 员 Alex Beregszaszi 和 Pawel Bylica。 主 要 引进 了 一 种 叫 作 “位 移 ” 
( Bitwise Shifting ) 的 运算 符 。 以 太 坊 虚拟 机 (EVM ) 之 前 缺少 这 种 运算 符 ， 只 支持 其 他 逻 

辑 和 算术 运算 符 ， “位 移 ”运算 符 只 能 通过 逻辑 和 算术 运算 符 实现 , 现在 通过 原生 支持 的 “位 
移 ” 运 算 符 能 优化 智能 合约 类 DApp 的 Gas ( 燃料) 消耗 ， 因 为 Gas 的 消耗 与 字 节 数据 量 的 
多 少 有 关 。 

e EIP1014: 由 以 太 坊 创始 人 Vitalik Buterin 亲自 提出 。 新 增 了 一 个 合约 创建 函数 CREATE2， 提 
供 了 一 种 可 以 提前 预测 合约 地 址 的 合约 创建 方法 ， 该 升级 能 更 好 地 支持 基于 状态 通道 或 者 链 
下 交易 的 扩容 解决 方案 ， 即 现在 主流 的 Layer2 方案 。 

e EIP1052: 出 自 以 太 坊 核心 开发 人 员 Nick Johnson 和 Pawel Bylica。 引 入 了 一 个 新 的 操作 码 ， 
允许 直接 返回 合约 字 节 码 的 keccak256 哈 希 值 ， 该 升级 能 有 效 地 减少 以 太 坊 网 络 对 于 大 型 智 
能 合约 的 运算 量 ， 尤 其 是 在 只 需要 智能 合约 的 哈 硕 值 的 时 候 。 

e EIPI234: 该 升级 主要 是 将 现 有 的 区 块 奖励 由 3ETH 减少 到 2ETH, 减少 了 33%， 同 时 将 难度 
炸弹 (Difficulty Bomb ) 推迟 了 12 个 月 。 

e EIP1283: 该 升级 通过 更 改 SSTORE 操作 码 优化 智能 合约 网 络 存 储 的 Gas 值 ， 减 少 了 和 智能 
合约 运行 量 不 匹配 的 Gas 消耗 。 


da) 从 以 太 坊 压 层 虚拟 机 到 智能 合约 的 一 系列 内 容 ， 提 高 了 整个 以 太 坊 网 络 的 性 能 。 

(2) 位 移 运 算 符 、 新 的 虚拟 机 操作 码 、 优 化 合约 网 络 存储 的 Gas 值 ， 使 得 虚拟 机 运算 合约 代 
人 码 速度 更 快 ， 运 算 量 更 少 ， 最 终 消耗 合约 调用 者 的 Gas ED 更 少 ， 对 开发 者 更 加 友好 了 。 

(3) 难度 炸弹 延缓 一 年 ， 区 块 奖励 从 3 减少 到 2， 导 致 节点 中 矿工 的 实际 收益 减少 了 1/3， 直 
接 关 系 到 矿工 的 利益 。 


2.7 URI} Ghost 协议 


“Ghost 协议 ”的 全 称 是 “Greedy Heaviest-Observed Sub-Tree protocol" , "P XAR AE Tb 
协议 ， 又 称 幽 灵 协 议 ， 它 属于 主 链 选 择 协 议 范 畴 。 

首先 ， 比 特 币 公 链 是 根据 最 长 链 规 则 来 解决 区 块 链 分 又 问题 的 ， 但 并 不 是 所 有 的 区 块 链 公 链 
解决 分 又 问题 都 是 使 用 最 长 链 规则 ， 以 太 坊 就 不 是 。 

以 太 坊 解决 区 块 链 分 又 问题 目前 使 用 的 是 Ghost 协议 , 而 Ghost 协议 的 真实 作用 是 用 来 进行 主 
链 选择 。 不 同 于 比特 币 的 最 长 链 规 则 ， 以 太 坊 在 选择 最 长 链 时 不 以 哪 条 链 区 块 连 续 最 长 为 标准 ， 而 
是 将 分 又 区 块 也 考虑 了 进去 , 选择 出 一 条 包含 了 分 又 区 块 在 内 区 块 数 目 最 多 的 链 作 为 最 长 链 , 如 图 
2-44 Bro. 


62 | 区 块 链 以 太 坊 DApp 开发 实战 


ES e p “ee 


根据 幽灵 协议 规则 选 
ES 中 的 最 优 和 


2-44 Ghost 协议 和 最 长 链 规则 选中 的 不 同 链 


请 看 图 2-44 的 分 叉 情 况 ， 在 比特 币 公 链 中 最 终 胜出 的 链 是 0<-1A<-2C<-3F<- 4B <- SA， 这 是 
一 条 由 最 长 链 规则 选择 的 链 。 而 在 以 太 坊 公 链 中 ， 根 据 幽 灵 协 议 最 终 胜 出 的 链 是 
0<-1A<-2B<-3D<-4A。 原 因 是 在 图 2-44 的 分 又 情 况 中 ， 幽 灵 协 议 把 分 又 区 块 也 考虑 进去 了 ， 统 计 
总 的 区 块 数 ， 发 现在 包含 了 区 块 0、1A、2B、3E、3D、3C、4A 的 链 是 含有 区 块 数 最 多 的 。 因 此 
该 链 胜出 ， 这 就 是 幽灵 协议 选择 最 优 链 的 机 制 。 

此 外 ， 对 于 在 最 长 链 中 被 包含 进去 的 造成 链 分 叉 的 区 块 ， 例 如 图 2-44 中 的 3E 和 3C, Ghost 
协议 对 它们 也 有 一 套 对 应 的 处 理 机 制 ， 这 些 区 块 会 根据 规则 被 处 理 为 : 


(OD 孤 块 。 完 全 没 用 的 区 块 ， 控 出 这 个 区 块 的 矿工 没有 任何 收益 。 比 特 币 链 中 的 分 又 区 块 都 
(2) 叔 块 。 被 一 定 范围 内 的 后 续 子 区 块 打 包 收 纳 的 区 块 ， 挖 出 叔 块 的 矿工 会 按照 一 定 算 法 给 
Tuas. 


综 上 所 述 ， 我 们 知道 ，Ghost 协议 在 以 太 坊 中 主要 起 到 以 下 两 点 作用 : 


(OD 选择 出 最 优 链 。 
(20 对 最 优 链 中 分 又 块 进行 处 理 。 


2.8 Casper: Pos 的 变种 共识 机 制 


前 和 面谈 到 ， 以 太 坊 Serenity CT 8$) 版 本 将 会 把 共识 机 制 完全 切换 成 “PoS” 的 共识 机 制 ， 这 
个 共识 机 制 还 有 另外 一 个 名 称 “Casper 投注 共识 ”。 以 太 坊 的 “Casper 投注 共识 ”属于 “PoS” 
共识 机 制 范 畴 ， 它 是 在 “PoS” 股 权证 明 思 想 上 拓展 衍生 出 的 一 种 股权 证 明 机 制 。 因 为 “Casper” 
版 本 还 没有 完全 公布 ， 笔 者 也 只 能 从 现 有 的 资料 中 归纳 出 它 的 一 些 特点 。 

“Casper 投注 共识 ”增加 了 惩罚 机 制 ， 并 基于 “PoS” 的 思想 在 记 账 节点 中 选取 验证 人 ， 验 证 
人 对 应 的 就 是 股权 拥有 者 ， 投 注 是 验证 人 上 所 拥有 的 动作 ， 且 能 够 投注 的 角色 只 能 是 “验证 人 ”。 可 
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以 将 这 类 角色 理解 为 新 一 代 以 太 坊 矿工 ， 因 为 投注 如 果 获 胜 是 会 有 收益 的 ， 相 当 于 挖 矿 收 益 。 
投注 指 的 是 在 “Casper 共识 机 制 ” 中 ， 验 证 人 要 拿 出 保证 金 的 一 部 分 对 它 认 为 的 大 概率 胜出 
区 块 进行 下 注 ， 类 似 于 赌博 ， 投 注 所 能 产生 的 结果 是 : 


A) 赌 对 了 ， 可 以 拿 回 保证 金 外 加 区 块 中 的 交易 费用 ， 也 许 还 会 有 一 些 新 发 的 货币 。 

(2) 下 注 太 慢 没 有 迅速 达成 一 致 ， 能 拿 回 部 分 下 注 金 ， 相 当 于 损失 了 一 些 下 注 金 。 

(o 数 个 回合 之 后 下 注 的 结果 出 来 ， 那 些 选 错 了 的 验证 人 会 输 邱 下 注 金 。 

(4) 验证 人 过 于 显 着 地 改变 下 注 ， 例 如 先 赌 共 个 区 块 有 很 高 的 概率 胜出 ， 然 后 又 改 赌 另外 一 
个 区 块 有 很 高 的 概率 胜出 ， 将 会 被 惩 避 。 


2.8.1 如 何 成 为 验证 人 


想 成 为 验证 人 ， 和 需要 区 保证 金 进行 申请 ， 同 时 也 可 以 在 进入 后 选择 退出 ， 加 入 和 退出 都 将 会 
成 为 以 太 坊 网 络 中 的 一 种 特殊 交易 类 型 ， 目 前 最 音 见 的 交易 就 是 转账 ETH 代 币 。 也 就 是 说 ， 到 时 
候 可 能 要 调用 一 定 的 以 太 坊 接口 来 申请 成 为 验证 人 。 保 证 金 很 有 可 能 就 是 以 太 坊 ETH 代 币 ， 它 将 
会 被 用 来 投注 ， 或 因 被 以 太 坊 的 惩 避 而 没收 拯 投 注 金 。 

目前 Casper 的 验证 人 逻辑 通过 一 个 名 称 为 Casper 的 合约 来 实现 ， 该 合约 提供 投注 、 加 入 、 取 
我 和 获取 共识 信息 等 一 系列 功能 ， 因 此 通过 简单 地 调用 Casper 合约 就 能 提交 投注 或 者 进行 其 他 操 
fF. Casper 合约 的 内 部 状态 如 图 2-45 所 示 。 


Return address: 0xa129eb234ca5 
Validators Deposit size: 1500000000000000000000 
Validation code: 0x600580600b60003 
96010566005602052 


Seq: 4 

Prevhash: 0xbc124f7e 

(| 3 [0x8a7f040d|0x45abe61d| 0.6667 | 
|  [0x8801c137| 0.3333 | 


u | 
| 1 [o0x91dc7825|0x61f24ab1| 0.8500 
| O |[0xfc75d467 | 0xba7124c 


2-45 Casper 合约 验证 人 的 数据 字段 组 成 
从 图 2-45 可 以 看 到 ， 这 个 合约 记录 了 当前 验证 人 的 信息 , 每 位 验证 人 有 6 项 , 分 别 说 明 如 下 : 


Return address， 验 证 人 保证 金 的 返还 地 址 (钱包 地 址 ) 。 

Deposit size， 当 前 验证 人 保证 金 的 数量 ( 注意 验证 人 的 投注 会 使 这 个 值 增加 或 减少 ) 。 
Validation code， 验 证 人 的 验证 代码 。 

Seq， 最 近 一 次 投注 的 序号 。 

Prevhash， 最 近 一 次 投注 的 哈 希 值 。 

验证 人 每 次 投注 的 表格 。 


2.8.2 ”验证 人 如 何 获 取保 证 金 


目前 验证 人 获取 保证 金 的 方式 ， 或 者 说 获取 代 币 的 方式 ， 主 要 是 基于 “PoS ”共识 机 制 ， 即 可 
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以 通过 转让 、 交 易 的 方式 来 获取 。 
如 果 是 早期 版 本 则 是 基于 POW 挖 矿 获 取 ， 如 末 涉 及 网 络 升级 ， 还 要 考虑 莱 容 旧 节 点 的 情况 。 


2.8.8 ”候选 区 块 的 产生 


验证 人 要 投注 的 对 象 是 区 块 ， 那 么 在 “Casper 投注 机 制 ” 中 区 块 将 由 谁 产生 ? 毕竟 只 有 区 块 
被 产生 了 才能 有 投注 的 动作 。 

答案 是 ， 区 块 将 由 验证 人 出 块 。 出 块 是 一 个 独立 于 其 他 所 有 事件 而 发 生 的 过 程 : 验证 人 负责 
收集 交易 ， 当 轮 到 它们 的 出 块 时 间 时 ， 它 们 就 制造 一 个 区 块 ， 然 后 签名 发 送 到 节点 网 络 上 去 。 

轮流 出 块 的 规则 也 是 由 “Casper” 提 供 的 。 


2.8.4 胜出 区 块 的 判断 


等 所 有 验证 人 都 在 限定 的 时 间 内 投注 完了 ， 在 所 有 压 了 注 的 区 块 中 哪个 将 会 胜出 呢 ? 

区 块 胜 出 的 规则 是 这 样 的 : 当 验 证 人 中 的 绝 大 多 数 ， 即 满足 协议 定义 国 值 的 一 群 验证 人 的 总 
保证 金 比 例 达 到 67% 到 90% 之 间 的 某 个 百分比 ， 并 以 非常 高 的 占 比 率 下 注 某 个 区 块 胜出 的 时 候 ， 
此 区 块 便 会 胜出 。 

不 难看 出 ，“Casper” 的 投注 方式 存在 验证 人 联盟 共同 投注 某 个 区 块 使 之 胜出 的 非 公平 问题 。 
对 于 这 个 问题 ， 目 前 以 太 坊 还 没有 很 好 的 解决 方案 。 


2.9 RENZ 


2.9.1 简介 与 作用 


我 们 生活 中 所 认识 的 合约 又 称 合同 ， 是 基于 文字 制定 的 条 球 ， 例 如 劳工 合同 。 

在 以 太 坊 中 ， 智 能 合约 也 可 以 看 作 是 一 份 合同 ， 它 的 表现 方式 是 : 使 用 规定 的 计算 机 语言 
程 ， 然 后 编写 一 份 代表 合同 的 代码 文件 ， 再 经 过 编译 ， 变 成 可 被 执行 的 计算 机 字 节 码 。 

可 见 ， 以 太 坊 的 智能 合约 也 可 以 理解 为 一 份 代 码 文 件 ， 例 如 用 C++ 语言 编写 的 是 .cpp 文件 ， 
用 Java 编写 的 是 .java 文件 。 

目前 以 太 坊 智能 合约 的 编程 语言 是 Solidity， 采 用 Solidity 语言 就 可 以 编写 出 各 种 各 样 的 智能 
合约 ， 然 后 将 其 部 署 到 以 太 坊 上 ， 部 署 的 详细 流程 是 : 


CD 编写 好 智能 合约 代码 文件 。 

(2) 经 过 Solidity 编 详 器 ， 将 代码 文件 编 详 成 十 六 进 制 码 。 

(3) 将 编译 好 的 十 六 进 制 码 ， 以 以 太 坊 交易 的 形式 发 送 到 以 太 坊 网 络 上 。 

(4) 以 太 坊 识别 出 是 部 署 合约 的 交易 ， 校 验 后 ， 存 储 起 来 。 

(5) 符合 约 被 链 下 请 求 调 用 的 时 候 ， 以 太 坊 智能 合约 虚拟 机 CEVMO 将 编写 好 的 智能 合约 代 
码 文件 编译 成 二 进 制 码 ， 并 加 载运 行 。 
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从 部 普 到 被 运用 的 整个 流程 ， 产 生 了 上 所谓 的 基于 智能 合约 的 DApp 应 用 。 

请 看 下 面 知 能 合约 的 例子 : 

pragma solidity ^0.4.17; 

contract MathUtil { 

function add(uint a,uint b) pure public returns (uint) { 
return (a+b); 

| } 

很 明显 ， 这 是 一 个 简单 的 加 法 操作 ， 但 这 也 是 一 份 智能 合约 ， 只 不 过 是 一 份 简单 的 智能 合约 。 

注意 ， 每 一 份 被 部 蜀 到 以 太 坊 上 的 智能 合约 都 有 一 个 唯一 标识 的 哈 希 地 址 值 ， 这 个 哈 希 地 址 
值 既 代表 用 户 的 以 太 坊 账户 地 址 ， 又 唯一 标识 了 一 份 智能 合约 。 

我 们 知道 ， 代 码 在 编译 成 可 执行 的 字 节 人 码 之 后 是 可 以 被 调用 执行 的 ， 同 样 地 ， 所 有 被 编译 布 
署 到 以 太 坊 中 的 智能 合约 也 可 以 被 调用 , 也 就 是 上 面 的 加 法 智能 合约 是 可 以 被 调用 的 。 注意 ， 这 里 
的 调用 指 的 是 合约 里 所 编写 的 函数 可 以 被 以 各 种 方式 调用 。 可 以 定义 私有 函数 ， 供 智能 合约 调用 ; 
也 可 以 添加 Owner 权限 (只 能 是 Owner? ， 由 合约 发 布 者 调用 或 公共 调用 。 

对 于 能 够 被 公共 调用 的 智能 合约 函数 ， 其 所 面 回 的 最 为 广大 的 调用 者 就 是 所 有 人 ， 你 可 以 调 
用 ， 人 他、 我 也 可 以 调用 。 怎 样 调用 呢 ? 可 以 通过 以 太 坊 提供 的 RPC 接口 。 当 然 ， 以 太 坊 也 提供 了 
传统 的 RESTful API 的 调用 方式 ， 也 就 是 我 们 可 以 将 调用 智能 合约 的 函数 理解 为 调用 服务 剖 接 口 。 

下 面 我 们 来 理 清 一 些 关系 : 

@ 智能 合约 -被 布 署 到 以 太 坊 节点 上 一 调用 时 被 以 太 坊 虚拟 机 编译 并 加 载 . 

@ 以 太 坊 节点 一 被 布 署 在 不 同 的 服务 器 上 一 节点 们 共同 维护 以 太 坊 公 链 。 

e 调用 者 一 调用 以 太 坊 节点 的 接口 一 访问 菜 个 智能 合约 一 获得 结果 。 


我 们 知道 ， 节 点 网 络 分 为 公 链 节点 网 络 和 私 链 节 点 网 络 ， 在 不 同类 型 的 节 扣 网 络 中 部 罗 的 哲 
能 合约 ， 其 访问 域 是 不 同 的 ,私有 节点 网 络 部 普 的 智能 合约 只 能 在 访问 私有 节点 网 络 时 才能 访问 到 
这 个 合约 ， 而 公有 基点 部 普 的 智能 合约 ， 所 有 人 都 可 以 调用 。 

如 图 3-46 所 示 是 访问 私有 节点 网 络 智能 合约 的 模型 图 。 


开发 者 A 部 署 智 能 合约 
编写 智能 合约 
调用 以 太 坊 接口 


访问 智能 合约 


图 3-46 访问 私有 节点 网 络 智能 合约 的 模型 图 
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部 署 在 以 太 坊 网 络 上 的 智能 合约 就 像 部 亚 了 一 个 服务 端 程 序 ， 我 们 通过 调用 在 智能 合约 中 编 
写 的 函数 可 以 实现 各 种 应 用 ， 这 正 是 以 太 坊 智能 合约 的 作用 。 例 如 ，ERC20 代 币 的 标准 智能 合约 
代码 中 就 有 一 个 转账 函数 ， 而 所 有 的 ERC20 标准 的 代 币 合约 ， 它 们 的 转账 就 是 通过 调用 这 个 函数 
实现 的 。 也 就 是 说 ，ERC20 代 币 转账 就 是 基于 智能 合约 的 ，ERC20 的 代 币 有 很 多 种 ， 每 一 种 代 币 
对 应 一 份 智能 合约 。 我 们 发 布 ERC20 代 币 到 链 上 ， 其 本 质 就 是 发 布 一 份 智能 合约 。 


29.2 合约 标准 


我 们 知道 ， 动 物 是 生物 的 一 个 种 类 ， 在 动物 的 大 范围 下 又 分 人 类 、 猫 类 、 鱼 类 等 。 类 似 地 ， 
以 太 坊 智能 合约 也 是 一 个 对 合约 的 统称 , 在 此 合约 下 ,又 有 特别 针对 一 类 合约 的 标准 , 例如 标准 的 
代 币 合约 标准 一 一 ERC20 代 币 标准 、ERC721 标准 等 ， 如 图 2-47 所 示 。 


ERC20 标准 代 币 合约 
ERC223 代 币 合约 


以 太 坊 智能 合约 ERC721 唯一 性 合约 
ERC777 合约 
其 它 
247 以太 坊 智能 合约 的 分 类 

本 书 我 们 主要 介绍 两 种 广泛 使 用 且 代 表 性 比较 强 的 合约 标准 : ERC20 与 ERC721。 

1. ERC20 标准 

我 们 首先 来 认识 ERC20 标准 。 

ERC 的 全 称 是 “Ethereum Request for Comments”， 中 文 含义 为 “以 太 坊 征询 意见 ”。 后 级 添 
加 的 数字 (例如 20、223 等 ) 是 版 本 号 。 

ERC20 标准 的 官方 解析 链接 : 

https://github.com/ethereum/EIPs/blob/master/EIPS/eip-20.md 

ERC20 标准 的 诞生 起 因 于 以 太 坊 的 应 用 本 质 , 由 于 以 太 坊 目前 几乎 都 是 被 应 用 于 虚拟 货币 中 ， 
包 插 以太 坊 本 身 也 有 代表 它 自己 的 虚拟 货币 : ETH。 因 此 ， 几 乎 所 有 使 用 以 太 坊 智能 合约 在 以 太 坊 
上 部 垩 的 合约 都 是 代表 虚拟 货币 的 智能 合约 。 

作为 货币 ， 它 日 然 有 货币 的 属性 ， 例 如 货币 名 称 、 货 币 发 行 量 及 货币 的 唯一 标识 等 。 为 什么 
名 称 不 是 唯一 标识 ? 这 是 因为 以 太 坊 限定 了 进行 唯一 标识 的 只 有 哈 希 值 , 所 以 虚拟 货币 的 名 称 是 允 
许 重复 的 ,比如 两 份 不 同 的 ERC20 标准 合约 ,它们 代码 中 的 name 或 symbol 变量 都 可 设置 为 ETH2。 
货币 除 拥有 上 面 的 属性 外 ， 还 必须 允许 用 户 得 询 余 笑 和 转账 ， 这 些 都 是 货币 所 拥有 的 基本 特点 。 

对 于 代表 虚拟 货币 的 智能 合约 来 说 ， 为 方便 虚拟 货币 的 发 布 ， 众 生 了 ERC20 标准 ， 该 标准 现 
在 已 经 被 专门 用 来 发 布 虚拟 货币 ， 标 准 中 包括 了 成 员 变量 、 函 数 和 事件 等 ， 以 方便 开发 者 调用 .。 

ERC20 标准 是 一 种 软 性 强制 的 标准 ， 因 而 并 不 是 发 布 虚 拟 货币 都 必须 遵照 这 个 标准 ， 这 标准 
里 面 的 一 些 属性 和 函数 ， 开 发 者 可 以 刹 循 也 可 以 目 己 创新 。 但 是 ,请 注意 ,目前 很 多 的 以 太 坊 钱包 
软件 在 设 定 进行 代 币 转账 时 ， 鸭 认 使 用 ERC20 标准 的 函数 名 称 和 传 参 类 型 。 所 以 ， 如 果 你 的 代 币 
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不 遵循 该 标准 发 行 ， 就 有 可 能 导致 钱包 软件 转账 失败 。 
下 面 我 们 根据 官方 文档 对 ERC20 标准 的 成 员 变量 、 函 数 和 事件 进行 讲解 。 
(1) 标准 的 成 员 变量 
ERC20 标准 规定 了 智能 合约 在 使 用 Solidity 语言 编程 时 可 以 通过 下 述 形式 来 定义 成 员 变量 : 


string public name; 


e 
€ string public symbol; 

€ uint8 public decimals; 
E 


uint256 public totalSupply; 
说 明 : 


(D string 用 来 定义 name 和 symbol 为 字 从 串 类 型 的 变量 ，uint8 表示 decimals 是 8 位 (bit) 的 
无 符号 整 型 数字 ，uint256 定义 变量 totalSupply 是 256 位 bit) 的 无 符号 整 型 数字 。 无 符号 的 整 型 
数字 可 取 的 正 数 范 围 变 大 了 ， 其 最 小 值 是 0， 但 不 能 取 负 数 。 
(2) name 一 般 表 示 当 前 代 币 的 名 称 ， 例 如 My First Token. 
(3 symbol 表示 当前 代 币 的 符号 , 代表 的 是 一 种 简称 , 例如 可 以 取 name 的 3 个 首 字母 来 设置 ， 
My First Token 的 3 个 首 字母 是 MFT。 
对 于 symbol， 请 注意 以 下 两 点 : 
e 我 们 一 般 口 头 上 说 一 个 代 币 的 时 候 ， 说 的 都 是 symbol 符号 。 例 如 ，LRC 就 是 一 个 symbol 符 
3. 
€ symbol 不 能 唯一 标识 一 个 代 币 。symbol 是 可 以 重复 的 ， 只 有 代 币 的 合约 地 址 才能 唯一 标识 代 
币 ， 所 以 不 要 以 symbol 来 唯一 标识 一 个 代 币 。 


一 般 来 说 ，name 和 symbol 都 可 以 任意 设置 ， 也 可 以 设置 为 同一 个 字符 串 ， 但 要 正规 地 表示 一 
个 代 币 ， 还 是 要 进行 妥善 设置 ， 因 为 这 些 合约 的 代码 都 能 在 “区 块 链 浏 览 器 ”被 搜索 并 且 浏 览 的 。 

(4) decimals 表示 将 代 币 单位 精确 到 小 数 点 后 多 少 位 ， 比 如 总 量 初始 化 为 1000, decimals 为 1 
( 即 代 币 单位 精确 到 小 数 点 后 1 位 ， 也 就 是 0.1) ， 则 实际 是 000 个 代 币 C100» 10! 2 1000， 即 有 
1000 个 0.1) ， 此 时 如 果 你 要 从 钱包 软件 中 辣 别 人 发 送 1 个 代 币 , 在 钱包 里 不 能 写 1， 而 是 要 写 10, 
因为 写 1 表示 发 送 0.1 个 代 币 (因为 精确 到 0.1) ， 通 过 交易 可 以 查看 到 实际 发 送 的 就 是 0.1， 所 以 
如 果 你 要 发 行 1000 个 代 币 , 那么 在 智能 合约 中 的 初始 设置 应 该 是 total = 1000 X 104595 (HHR E 
10 的 decimals 次 方 ) ， 发 行 的 数量 需要 相对 代 币 小 数 点 后 的 位 数 来 设置 。 例 如 ， 如 果 精 确 到 小 数 
点 后 的 位 数 是 0， 而 你 要 发 行 1000 个 代 币 ， 那 么 发 行 数量 的 值 是 1000， 因 为 代表 单位 精确 到 1。 
但 是 ， 如 果 代 币 单 位 精确 到 小 数 点 后 的 位 数 是 18 位 ， 你 要 发 行 1000 个 代 币 , 那么 发 行 数 量 的 值 就 
是 1000000000000000000000 (1000 后 面 加 上 18 个 0) ， 因 为 代 币 单位 精确 到 小 数 点 后 18 位 。 

© totalSupply 代表 当前 代 币 的 总 发 行 量 ， 留 意 到 它 对 应 的 是 uint256 整 型 数字 ， 即 256 位 的 
无 符号 整 型 数字 ， 而 不 是 8 位 ， 就 知道 这 个 数字 表示 的 范围 是 很 大 的 。 假 设 decimals 是 18， 然 后 
我 们 发 行 量 是 100 亿 个 代 币 ， 那 么 此 时 totalSupply 的 真实 数值 是 totalSupply = 100X 10/5. 3x 4X 
字 非 常 之 大 , 一 般 整 型 会 淤 出 ， 所 以 要 按照 标准 的 规则 来 定义 好 你 的 变量 ， 以 避免 出 现 数 据 洲 出 的 
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以 上 我 们 介绍 了 4 个 标准 的 成 员 变 量 ， 那 么 是 不 是 一 定 要 按照 标准 必须 使 用 这 4 个 变量 呢 ? 
不 是 的 ， 请 记 住 ， 智 能 合约 中 的 代码 可 以 不 按照 标准 写 ， 例 如 代 币 的 名 称 ， 标 准 中 要 求 使 用 name 
来 表示 ， 但 是 你 想 换个 变量 来 表示 ， 比 如 换 成 tokenName， 那 么 需要 在 合约 中 编写 特定 的 函数 ， 以 
便 合 约 调 用 者 可 以 访问 到 这 个 tokenName 变量 。 

具体 见 下 面 ERC20 函数 的 说 明 。 


(2) 标准 的 函数 
ERC20 标准 规定 了 智能 合约 须 具备 并 实现 下 面 的 函数 及 事件 《Event) : 
contract ERC20 í 
function totalSupply() constant returns (uint256 totalSupply); 
function balanceOf(address owner) constant returns (uint256 balance); 
function transfer(address to, uint256 value) returns (bool success); 
function transferFrom(address from, address to, uint256 value) returns 
(bool success); 
function approve(address spender, uint256 value) returns (bool success); 
function allowance(address  owner,address spender) constant returns 
(uint256 ret); 


event Transfer(address indexed from, address indexed to, uint256 value); 
event Approval(address indexed owner, address indexed spender, uint256 
| value); 


} 

以 上 ERC20 标准 中 的 各 个 函数 都 要 求 使 用 代码 来 实现 ， 有 具体 怎么 实现 ， 标 准 并 不 关心 ， 只 需 
要 返回 每 个 函数 所 规定 的 参数 类 型 即 可 。 例如 ，balanceOf 函数 的 功能 是 查询 钱包 地 址 的 代 币 余额 ， 
只 要 结果 返回 余额 的 值 即 可 。 这 种 情况 就 像 Java 语言 中 的 接口 ， 定 义 好 接口 ， 具 体 的 实现 ，Java 
并 不 关心 。 

下 面 我 们 对 上 述 标准 中 的 各 个 函数 分 别 进行 说 明 。 

GO 返回 代 币 发 行 量 的 函数 totalSupply 

totalSupply() constant returns (uint256 totalSupply) 


这 个 图 数 要 求 返 回 当 前 代 币 的 总 发 行 量 ， 返 回 的 值 就 是 totalSupply 的 数值 。 注 意 ， 如 果 你 不 
明确 地 在 智能 合约 中 写 出 返回 totalSupply 的 函数 , 但 是 定义 了 totalSupply 变量 ,那么 EVM 虚拟 机 
在 编译 的 时 候 会 自动 帮 你 加 上 返回 totalSupply 的 函数 。 例 如 ， 下 面 的 这 个 函数 是 在 定义 了 
totalSupply 变量 但 没有 明确 写 出 totalSupply 这 个 函数 时 EVM 自动 加 上 的 。 

function totalSupply() constant returns (uint256 totalSupply)t 


return 1000000000000000000000 // 已 经 自动 乘 上 了 decimals 的 格式 
} 


D 返回 代 币 余额 的 图 数 balanceOf 


balanceOf (address owner) constant returns (uint256 balance) 


balanceOf 的 作用 是 返回 一 个 钱包 地 址 所 拥有 当前 代 币 的 余额 ， 供 查询 余额 所 用 ， 只 需要 传 入 
一 个 钱包 地 址 ，address 类 型 代表 的 就 是 地 址 类 型 ， 最 后 返回 的 是 代 币 的 余额 ， 其 结果 也 是 乘 上 了 
decimals 后 的 数字 格式 。 
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(3) 转账 函数 transfer 


transfer (address to, uint256 value) returns (bool success) 


transfer 的 作 有 用， 顾名思义 就 是 转移 ， 即 用 于 转移 代 币 的 转账 了 水 数 。 入 参 分 别 是 要 接收 代 币 的 
以 太 坊 地 址 to， 以 及 要 转 多 少 的 数值 _value。 你 可 能 想到 了 ， 为 什么 没有 from? 从 哪个 地 址 转 出 
E? 答案 是 这 个 函数 内 部 的 实现 一 般 都 是 把 下 面 的 两 种 地 址 角色 作为 默认 的 转账 地 址 : 

e 当前 调用 这 个 转账 函数 的 地 址 msg.sender ， 它 是 函数 代码 中 的 一 个 变量 。 

e 合约 创建 时 所 设置 的 最 初 的 收 币 地 址 。 


关于 上 面 的 第 二 点 ， 这 里 举例 做 一 个 说 明 。 

假设 钱包 地 址 XXX 是 合约 A 此 刻 transfer 的 调用 者 , 这 时 A 的 调用 者 msg.sender 就 是 XXX, 
然后 在 智能 合约 代码 里 的 transfer 函数 实现 的 时 候 要 写 明 从 地 址 YYY 中 转 出 ， 如 下 代码 所 示 : 

function transfer (address to, uint256 value) returns (bool success) { 


UE: [ YYY ] -= value; // 注意 这 行 的 vvv 作为 默认 转 出 地 址 


balanceOf [ to ] += value; 


} 

转账 相关 的 函数 还 有 transferFrom， 它 和 transfer 一 样 ， 也 用 于 实现 转账 的 功能 。 

transferFrom(address from, address to, uint256 value) returns (bool 
success); 

不 同 的 地 方 在 于 转账 的 形式 : transferFrom 是 从 某 个 钱包 地 址 from [8] to 转账 ， from 是 传 参 
进来 的 ， 这 就 意味 看 我 们 可 以 设置 任何 钱包 地 址 为 转 出 地 址 。 这 里 要 注意 的 是 , 使 用 这 个 转账 函数 
的 前 提 是 必须 获得 授权 。 

(4) 授权 函数 approve 


approve(address spender, uint256 value) returns (bool success); 


approve 就 是 授权 函数 。 在 使 用 transferFrom 前 要 对 传 入 transferFrom 中 的 from 地 址 进行 它 所 
在 当前 代 币 的 授权 值 的 判断 ， 只 有 这 个 授权 值 满足 了 给 定 值 才能 使 用 transferFrom FR ZI. 

那么 ， 为 什么 要 授权 呢 ? 我 们 通过 一 个 例子 来 了 解 一 下 原因 ， 这 和 你 委托 你 的 一 个 朋友 去 帮 
你 转账 给 男 外 一 个 人 的 情况 是 一 样 的。 例如 ，A B 帮 A 转账 人 民 币 100 元 给 C， 这 个 时 候 由 于 
B 只 是 一 个 帮忙 转账 的 人 ， 它 是 没有 A 的 银行 卡 和 密码 的 ， 只 有 在 得 到 A 的 授权 后 才能 操作 ， 而 
且 授 权 也 是 有 一 个 数值 的 ， 例 如 100 元 。 那 么 A 就 先 回 银行 D 授权 日 己 的 转账 权限 给 B， 人 允许 B 
AREF A 转账 给 C 共 100 元 。 

以 上 就 是 approve 的 授权 流程 ， 首 先 合 约 A 的 调用 者 msg.sender 在 合约 A 中 授权 给 spender， 
允许 spender EARE A Gek value 个 数值 的 代 币 。 此 后 ，_spender 就 能 在 合约 A 中 调用 
transferFrom 从 from 中 转账 value 个 代 币 给 tb， 注意 这 时 的 from 就 是 当初 调用 approve 的 
msg.sender。 为 了 加 深 理 解 approve 和 transferFrom， 下 面 再 提供 一 个 流程 图 ， 如 图 2-48 所 示 。 
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E 调用 Approve, ilt Bdmsg.sender 
为 A, 1813 XX 代 币 转账 权限 给 B 


Approve 调用 
者 ， 授 权 者 用 户 A 


调用 transferFrom, 
帮 A 转账 给 c 


代 币 XX 的 智能 合约 


2-48 使 用 transferFrom 转账 的 流程 


一 般 来 说 ，transferFrom 的 内 部 实现 都 会 对 授权 值 进 行 判断 ， 当 然 ， 你 也 可 以 不 判断 ， 但 这 就 
不 是 标准 的 做 法 了 。 如 果 做 了 判断 ， 发 现 当前 调用 transferFrom 的 msg.sender 还 没有 授权 值 ， 就 会 
报 蚀 。 这 种 错误 统称 为 合约 层 的 非 编 译 时 错误 ， 只 能 通过 查看 智能 合约 代码 来 分 析 错 误 原 因 。 下 面 
是 approve 和 transferFrom 判断 授权 值 的 实现 代码 示例 : 


function transferFrom(address from, address to, uint256 value) public 
returns (bool success) 


{ 
uint256 allowance = allowed[ from][msg.sender]; // 取出 数值 


// 进行 数值 判断 ， 成 功 后 额度 数值 减 去 转 出 部 分 等 


return true; 


} 


function approve (address spender, uint256 value) public returns (bool success) 
{ 
allowed[msg.sender][ spender] = value;  // 进行 授权 值 设 置 


return true; 


} 
© KAHE AA ER XC allowance 


allowance (address | owner,address spender) constant returns (uint256 
ret); 


allowance 所 对 应 的 是 approve 所 授权 的 客 度 查询 ， 它 会 返回 _owner 地址 到 当前 代 币 合约 XX 
中 ， 方 便 查 询 owner 给 spender 授权 了 多 少 个 XX 代 币 的 数值 ， 也 是 我 们 在 开发 过 程 中 经 常 使 用 
HJ ER ŽI o 
(3) 标准 的 事件 (Event) 
上 面 我 们 介绍 的 是 ERC20 标准 的 函数 ， 其 实 ERC 标准 还 有 两 个 Event 事件 类 型 ， 下 面 对 这 两 
个 事件 进行 详细 介绍 。 事 件 是 Solidity 编程 语言 语法 中 的 一 类 特性 ， 其 作用 是 当 该 事件 的 代码 被 
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EVM 虚拟 机 调用 触发 时 能 够 以 消息 方式 啊 应 调用 者 前 站， 类 似 于 Java 语言 中 的 回调 函数 
(callback) . 
也 就 是 说 ， 我 们 可 以 目 己 在 代码 中 定义 想 要 的 事件 (Event) 。 在 ERC20 标准 中 ， 规 定 了 在 编 
写 转 账 、 授 权 函 数 代码 时 ， 必 须 在 成 功 转账 后 触发 转账 事件 。 我 们 首先 介绍 转账 的 事件 event. 


event Transfer (address indexed from, address indexed to, uint256 value); 


Transfer 事件 需要 在 transfer 和 transferFrom ER x V ALA. W RC ER Xo P3 ER SCIT EE, 
就 会 发 现 返 回 的 都 是 bool (布尔 ) 类 型 。 但 是 ， 请 注意 ， 在 真实 调用 的 时 候 ， 并 不 是 直接 通过 RPC 
接口 调用 这 两 个 函数 ， 而 是 通过 以 太 坊 的 交易 接口 来 调用 智能 合约 的 转账 函数 。 

在 调用 以 太 坊 的 交易 接口 时 ， 以 太 坊 会 返回 一 个 TxHash 值 ， 也 就 是 交易 的 哈 希 凭据 值 。 此 时 
客户 闹 也 就 是 调用 者 还 不 能 马上 知道 交易 结果 , 之 前 的 内 容 提 到 过 ,以太 坊 的 交易 需要 矿工 打包 到 
区 块 中 ， 所 以 需要 等 待 交 易 被 矿工 打包 到 区 块 后 才能 得 知 最 终 的 结果 。 

等 待 时 间 的 长 短 是 不 确定 的 ， 在 这 种 情况 下 就 需要 一 个 event (事件 ) 来 通知 ， 待 交易 被 矿工 
打包 到 区 块 后 ，EVM 虚拟 机 会 执行 智能 合约 的 转账 函数 ， 最 后 触发 event (事件 ) ， 随 后 客户 病 就 
能 在 监听 代码 中 处 理 最 终 的 结果 。 下 面 是 web3.js 的 一 个 例子 。 

// 实例 化 代 币 的 智能 合约 对 象 


var contract = new web3.eth.Contract (TokenABI, TokenAddress); 
// 发 起 转账 ，txHash 是 能 够 马上 被 返回 的 
Var txHash = contract.sendCoin.sendTransaction(To, 100, (from:From]) 
// 获取 事件 对 象 
Var myEvent = contract.Transfer(); 
// 监听 事件 ， 监 听 到 事件 后 会 执行 回调 函数 
myEvent.watch(function(err, result) { 
IE CIOTEN CT 
console.log (result); 
} else { 
console.log (err); 
} 
myEvent.stopWatching(); 
F)? 


此 外 ， 在 event 事件 中 ， 存 在 一 个 有 兰 特 殊 意义 的 变量 关键 字 ， 即 “indexed”。 在 以 太 坊 的 
事件 机 制 中 ， 对 于 成 功 触发 的 事件 ， 以 太 坊 会 对 事件 进行 数据 层面 的 存储 ， 方 便 开 发 者 用 科 选 需 
(Filter) 查找 ， 所 存储 事件 的 数据 区 域 对 应 的 术语 是 “Event Log”【〔 事 件 日 志 ) o “Event Log" 
分 两 部 分 ， 分 别 是 : 

e Topic 部 分 (主题 部 分 ) 。 在 智能 合约 函数 中 凡是 被 定义 为 “indexed” 类 型 的 参数 值 都 会 被 

保存 到 这 个 主题 部 分 。 

e Data 部 分 (数据 部 分 ) 。 没 有 被 定义 为 “indexed” 类 型 的 参数 值 会 被 保存 到 这 个 数据 部 分 。 


一 个 event (事件 ) 中 最 多 可 以 对 3 个 参数 添加 indexed 属性 标签 ,添加 了 indexed 的 参数 值 会 
存 到 日 记 结 构 的 Topic 部 分 ,便于 快速 查找 ， 而 未 加 indexed 的 参数 值 会 被 保存 在 Data 部 分 ， 成 为 
原始 日 志 。 需 要 注意 的 是 ， 如 果 添 加 indexed 属性 的 是 数组 类 型 (包括 string A bytes), WARS 
在 Topic 部 分 存储 对 应 数据 的 web3.sha3 哈 希 值 ， 将 不 会 再 保存 原始 数据 。 因 为 Topic 部 分 是 用 于 
快速 查找 的 , 不 能 保存 任意 长 度 的 数据 ， 所 以 通过 Topic 部 分 实际 保存 的 是 数组 这 种 非 固定 长 度数 
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据 的 哈 希 值 。 如 图 2-49 所 示 是 在 “区 块 链 浏 览 器 ”中 得 询 某 笔 交易 记录 的 “Event Logs” CHPH 
ms) 时 得 到 的 结果 。 


Overview Comments 

Block Height: 6670988 < > 

Timestamp: (9 187 days 22 hrs ago (Nov-09-2018 07:09:58 AM +UTC) 
Transactions: 


Mined by: : e = 960! 8 a0c4d1a5f6216f90f81501 ( 
y 打包 了 的 交易 数量 0x4bb96091ee9d8026ed039c4d1a5f6216f90181b501 (Ethpool 2) in 5 secs 


Block Reward: 3.143290272928818416 Ether (3 + 0.0495402729288184106 + 0.09375) 
三 部 分 奖励 


Uncles Reward. 1.875 Ether (1 uncle at Position 0) 


Difficulty: 2,955.240,733,037,238 


Total Difficulty: 7,706,121,856,488,461,535.198 


2-49. 区 块 链 浏览 器 的 Event Logs 


和 transfer 事件 一 样 ，ERC20 标准 在 代 币 授权 成 功 后 也 有 一 个 对 应 的 授权 事件 触发 。 

event Approval(address indexed owner, address indexed spender, uint256 
value); 

以 太 坊 结合 Solidity 语言 中 事件 机 制 , "e Bde y ERRE H CA fé 1 258 8] HT P e 7 98 — 1 I Ud 
功能 ， 即 异步 回调 ， 这 样 才 能 处 理 交 易 或 授权 的 结果 。 试 想 一 下 ， 我 们 转 了 一 笔 账 ， 却 不 知道 交易 
的 结果 是 怎样 的 ,转账 的 时 候 只 有 一 个 交易 哈 希 值 拿 到手， 要 想 知 道 结 果 ， 只 能 不 断 地 使 用 这 个 哈 
布 值 去 调用 以 太 坊 的 接口 进行 查询 , 或 者 手动 去 区 块 链 浏览 器 中 查询 。 这样 无 论 是 从 编写 代码 层面 
还 是 用 户 在 应 用 层面 的 体验 来 说 都 不 那么 友好 , 特别 是 批量 交易 的 应 用 场景 , 所 以 事件 的 回调 机 制 
在 一 定 程度 上 解决 了 这 个 问题 。 

捕获 交易 结果 除了 使 用 事件 回调 监听 形式 ， 还 可 通过 遍历 区 块 解析 其 过 程 来 达到 目的 ， 这 个 
方法 我 们 会 在 后 续 章 节 中 介绍 ， 并 给 出 代码 实现 。 

2. ERC721 标准 

以 上 我 们 认识 了 专门 为 代 币 而 设置 的 ERC20 标准 ， 但 是 在 现实 的 开发 中 ， 除 了 使 用 智能 合约 
来 发 布 代 币 之 外 ， 更 多 的 是 实现 和 生活 中 实业 相 结合 的 智能 合约 应 用 。 

想象 一 下 ， 现 实生 活 中 ， 人 与 物理 资产 的 对 应 关系 都 是 一 对 一 的 ， 例 如 你 买 了 一 辆 车 ， 这 个 
车 有 一 个 唯一 的 车 牌号 ， 且 所 有 权 归 你 ， 这 就 是 一 对 一 的 关系 。 如 果 要 把 这 种 关系 使 用 智能 合约 映 
射 到 区 块 链 上 ， 就 震 要 制定 一 类 合约 标准 来 专门 规范 这 种 一 对 一 的 资产 关系 。 

于 是 ，ERC721 标准 诞生 了 。ERC721 的 官方 解释 是 “Non-Fungible Tokens” , $555 7j NFTs, 
翻 详 为 非 同 质 代 币 ， 或 不 可 蔡 换 的 代表 。 

什么 是 非 同 质 代 币 呢 ? 关于 这 个 名 词 的 解析 ， 我 们 可 以 从 ERC20 和 ERC721 的 区 别 来 进行 。 
ERC20 标准 是 专门 为 发 布 虚拟 货币 〈 即 代 币 ) 制定 的 , 货币 的 发 行 有 发 行 量 , 例如 共 10 万 枚 代 币 ， 
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这 些 代 币 都 是 一 样 的， 没有 唯一 的 标识 ， 假 设 这 个 虚拟 货币 的 symbol 符号 是 XXX, ERC 标准 就 
把 这 10 万 枚 代 币 统称 为 XXX 币 。 而 在 ERC721 标准 中 , 它 把 个 体 唯一 化 了 ,同样 是 10 万 枚 代 币 ， 
假设 使 用 ERC721 标准 发 布 这 份 智能 合约 ， 那 么 这 10 万 枚 代 币 的 每 一 枚 都 会 单独 有 一 个 ID， 也 就 
是 说 ，10 万 枚 中 每 一 枚 都 各 自 有 唯一 的 标识 ， 彼 此 互 不 相同 ， 单 位 为 1， 且 无 法 再 分 割 。 

以 上 就 是 ERC20 和 ERC721 最 为 核心 的 区 别 ， 主 要 表现 在 合约 所 表示 的 物质 的 个 体 化 与 一 类 
化 方面 。 ERC721 的 这 个 特点 一 一 所 表示 的 物质 ( 代 币 ) 独一无二 ， 使 其 更 具有 价值 。 该 标准 很 好 
地 映射 了 现实 生活 中 一 对 一 的 关系 。 例 如， 生活 中 每 辆 车 的 车 牌号 是 独一无二 的 , 我 们 所 养 的 宠物 
的 基因 也 是 独一无二 的 ， 等 等 。 

2017 年 ， 有 一 球 基 于 ERC721 标准 开发 的 DApp 游戏 一 一 CryptoKitties EJH) ， 又 称 以 太 
猫 。 这 款 游戏 中 的 猫 对 象 就 是 独一无二 的 ， 每 只 猫 相 当 于 一 个 代 币 ， 都 拥有 一 个 唯一 标识 的 ID。 

如 果 把 物理 世界 的 资产 与 区 块 链 智能 合约 结合 起 来 看 ERC721 合约 显然 拥有 更 广泛 的 应 用 场 
景 。 但 在 DApp 开发 中 ， 究 竟 使 用 哪 一 种 合约 标准 ， 要 根据 项 目的 需要 来 决定 。 


CD 标准 的 成 员 变 量 

ERC721 标准 所 规范 的 成 员 变 量 和 ERC20 标准 的 基本 一 样 ， 但 是 ERC721 成 员 变 量 可 以 不 需 
要 decimal 变量 。 

name 依然 代表 当前 智能 合约 的 名 称 ，symbol 依然 是 符号 简称 ，totalSupply 代表 当前 有 多 少 个 
唯一 代 币 (Token) 。 

此 外 ， 除 了 标准 限定 的 成 员 变 量 ， 为 了 达到 ERC721 的 要 求 ， 一 般 还 需要 一 些 map 数据 结构 
的 变量 来 辅助 实现 代 币 的 拥有 者 和 当前 代 币 一 一 对 应 的 关系 。 


(2) 标准 的 函数 
合约 的 函数 和 事件 也 和 ERC20 的 大 部 分 一 样 ， 如 下 所 示 : 


contract ERC721 ( 

// Required methods 

function totalSupply() public view returns (uint256 total); 

function balanceOf (address owner) public view returns (uint256 balance); 

function ownerOf(uint256 tokenId) external view returns (address owner); 

function approve (address to, uint256 tokenId) external; 

function transfer (address to, uint256 $tokenId) external; 

function transferFrom(address from, address to, uint256  tokenIQd) 
external; 


// ERC-165 Compatibility (https://github.com/ethereum/EIPs/issues/165) 
function supportsInterface(bytes4  interfaceID) external view returns 
(bool); 


// Events 
event Transfer (address from, address to, uint256 tokenIdg); 
event Approval (address owner, address approved, uint256 tokenId); 


// Optional 可 选 实现 

function name() public view returns (string name); 

function symbol() public view returns (string symbol); 

function tokensOfOwner(address owner) external view returns (uint256[] 
tokenIds); 
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function tokenMetadata(uint256  tokenId, string preferredTransport) 
public view returns (string infoUrl); 


} 


相 比 ERC20 标准 ， 在 必须 实现 的 函数 中 ，ERC21 标准 多 了 ownerOf 函数 与 supportsInterface 
ER Žo 


function ownerOf(uint256 tokenId) external view returns (address owner); 


ownerOf 的 入 参 只 有 一 个 tokenId， 作 用 是 返回 当前 拥有 这 个 tokenId 的 代 币 的 拥有 者 的 地 址 。 


function supportsInterface(bytes4 interfaceID) external view returns (bool); 


supportsInterface 是 ERC165 标准 的 函数 ，ERC721 标准 也 会 用 到 这 个 函数 。ERC165 标准 的 原 
型 是 : 
interface ERC165 { 
// (notice Query if a contract implements an interface 
// (param interfaceID The interface identifier, as specified in ERC-165 


// (dev Interface identification is specified in ERC-165. This function 
// uses less than 30,000 gas. 

// (return 'true' if the contract implements 'interfaceID' and 

// 'interfaceID' is not Oxffffffff, 'false' otherwise 


function supportsInterface(bytes4 interfaceID) external view returns 
(bool); 


} 

根据 官方 对 ERC165 标准 的 注释 ， 该 标准 主要 的 作用 是 用 来 检测 当前 智能 合约 实现 了 哪些 接 
口 ， 可 根据 interfaceID 来 查询 接口 ID， 存 在 就 返回 true, 否则 返回 false。 该 标准 函数 还 会 消耗 Gas 
(燃料 ) ， 人 至 少 消耗 30000 Gas. 

下 面 举例 加 以 说 明 。 

假设 一 个 ERC721 智能 合约 里 面 有 一 个 函数 的 名 称 是 “getName”， 先 计算 出 该 函数 的 bytes4 
类 型 的 ID: 

bytes4 constant InterfaceSignature ERC721 = bytes4 (keccak256 (getName() ')) 


supportsInterface 的 内 部 实现 如 下 : 


function supportsInterface(bytes4 interfaceID) external view returns (bool)( 
return  interfaceID == InterfaceSignature ERC721; 
} 
当 _interfaceID 传 参 后 ， 直 接 进 行 bytes4 类 型 的 等 值 判 断 。 
上 面 的 supportsInterface 图 数 是 必须 实现 的 。 此 外 ，ERC165 标准 在 可 选 的 实现 图 数 中 还 有 一 
个 看 起 来 比较 难 理解 的 图 数 一 一 tokenMetadata。 


function tokenMetadata(uint256  tokenId, string jpreferredTransport) public 
view returns (string infoUrl); 


tokenMetadata 的 作用 主要 是 返回 代 币 的 元 数据 (Metadata) ， 内 部 返回 的 是 我 们 目 定 义 的 一 
个 字符 串 。 元 数据 是 什么 意思 呢 ? 就 是 基础 信息 ， 例 如 合约 里 的 name 和 symbol 就 是 基础 数据 ， 
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就 好 像 一 个 人 有 名 字 、 人 年 龄 和 性 别 一 样 ， 这 个 图 数 的 作用 就 是 返回 这 些 基 础 数据 。 一 般 来 说 ， 
tokenMetadata 可 以 用 来 返回 当前 智能 合约 的 创建 日 期 是 什么 时 候 、 名 称 是 什么 等 这 些 基础 数据 ， 
然后 将 这 些 基础 数据 拼接 成 一 个 字符 串 返 回 。 
在 事件 机 制 方面 ， ERC721 和 ERC20 是 完全 一 样 的 ， 这 里 就 不 再 歼 述 了 。 
关于 智能 合约 的 标准 ， 除 了 ERC20 和 ERC721， 还 有 很 多 ， 但 并 不 常用 ， 读 者 如 果 感 兴趣 可 
以 自行 了 解 。 


2.10 以太 坊 交易 


关于 以 太 坊 交易 ， 我 们 一 般 会 将 其 理解 为 转账 代 币 ， 但 是 其 本 质 上 实际 是 一 种 广义 的 交易 ， 
交易 的 内 容 不 仅仅 限于 转账 代 币 ， 也 可 以 是 转账 对 象 ， 这 个 对 象 就 是 在 使 用 Solidity 代码 实现 智能 
合约 的 时 候 所 定义 的 对 象 实体 。 例 如 , 在 以 太 猫 应 用 中 ,转账 的 是 猫 ， 而 不 是 代 币 。 可 以 这 样 理解 : 
交易 包含 了 转账 , 转账 仅 是 其 中 的 一 个 可 能 。 交易 双 方 通 过 地 址 关联 ， 这 个 地 址 就 是 前 面 一 节 中 谈 
到 的 以 太 坊 的 十 六 进 制 地 址 。 

本 节 我 们 将 详细 介绍 以 太 坊 交易 的 原理 和 概念 。 


2.10.1 交易 的 发 起 者 、 类 型 及 发 起 交易 的 函数 


交易 的 发 起 者 就 是 以 太 坊 的 使 用 者 ， 使 用 者 主要 有 两 拓 : 


(1) 节点 服务 ， 例 如 geth 控制 台 的 使 用 者 。 
(2) 调用 节点 服务 ， 指 geth 提供 RPC 接口 的 客户 端 ， 例 如 钱包 等 。 


交易 的 类 型 分 下 面 两 种 : 


(1) 以 太 坊 ETH 转账 交易 。 
(2) 其 他 交易 ， 这 类 交易 包含 但 不 限于 ERC20 代 币 的 转账 交易 。 


通常 ， 我 们 把 调用 了 以 太 坊 节点 程序 中 的 “eth sendTransaction ”或 “eth sendRawTransaction " 
接口 所 触发 的 动作 或 行为 称 为 以 太 坊 交易 。 目 前 以 太 坊 RPC 接口 提供 了 两 种 标准 的 交易 发 起 图 数 ， 
对 应 上 面 的 交易 类 型 ， 分 为 以 下 两 种 : 

(1) eth_sendTransaction， 该 用 数 仅 用 于 以 太 坊 ETH 转账 ， 参 数 最 终 的 签名 不 需要 调用 者 手 
动 进行 ， 它 会 在 当前 节点 中 使 用 已 解锁 的 发 起 者 from 的 以 太 坊 地 址 的 私 钥 进行 签名 ， 因 此 每 次 使 
用 这 个 函数 进行 以 太 坊 ETH 转账 时 ， 需 要 先 解锁 from 地 址 。 

(2) eth sendRawTransaction， 需 要 调用 者 使 用 from 私 钥 进 行 签名 参数 数据 的 交易 函数 ， 目 
Hj ERC20 代 币 转账 交易 都 是 使 用 这 个 国 数 。 以 太 坊 ETH 转账 交易 一 样 可 以 使 用 
“eth_sendRawTransaction” 来 进行 ， 但 转账 ETH 主要 由 参数 控制 ， 这 点 会 在 “交易 参数 的 说 明 ” 
一 节 中 介绍 。 

为 方便 阅读 ， 往 下 的 内 容 中 ， 对 于 “eth sendTransaction” 和 “eth sendRawTransaction ”简称 
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Jj *sendTransaction" AI *sendRawTransaction " 


2.10.2 ”交易 和 智能 合约 的 关系 


在 前 面 的 一 节 中 谈 到 智能 合约 中 的 transfer 图 数 ，ERC20 代 币 的 转账 交易 事实 上 调用 的 就 是 
智能 合约 的 transfer 函数 ， 那 么 智能 合约 层面 的 transfer 图 数 是 如 何 与 节点 RPC 接口 层 的 
sendRawTransaction 联系 在 一 起 的 呢 ? 本 节 我 们 来 回答 这 个 问题 。 

我 们 知道 , ERC20 代 币 转账 交易 的 第 一 步 是 调用 RPC 接口 , 即 调用 sendRawTransaction 接口 ， 
在 把 需要 转账 的 数据 传 给 节点 后 ， 节 点 会 提取 出 每 个 数据 字段 ， 其 中 就 包含 sendRawTransaction 的 
data 参数 ，data 是 一 个 十 六 进 制 学 符 串 ， 它 所 组 成 的 内 容 中 有 部 分 被 称 为 methodld, iX ID 对 应 的 
就 是 transfer 函数 的 名 称 转化 值 ， 即 transfer 单词 通过 一 定 运 算 后 产生 的 转化 值 。 

有 了 这 个 methodId， 等 到 转账 交易 被 矿工 打包 处 理 时 就 会 根据 合约 地 址 参数 先 找到 对 应 的 智 
能 合约 ， 合 约 地 址 参数 由 sendRawTransaction 的 to 参数 表示 ， 最 后 会 基于 找 出 的 合约 去 执行 数据 
data 字段 中 methodId 所 指示 的 函数 ， 以 及 读 取 这 个 函数 对 应 的 参数 数据 ， 例 如 转账 给 谁 、 转 多 少 。 

图 2-50 所 示 是 一 个 转账 交易 的 大 致 流程 图 。 


sendRawTransaction 


转账 传 参 : 
data = XXXX 
一 一 一 二 = to 三 XXXX 


应 用 程序 APP 


以 太 坊 主 网 ， 节 点 网 络 


矿工 打包 该 转账 ， 
EVM 根据 to 找到 对 应 的 智能 合约 并 根据 
data 参 数 执行 对 应 的 合约 函数 transfer 


代 币 XX 的 智能 合约 
图 2-50 ”转账 交易 流程 图 


也 就 是 说 ， 在 应 用 程序 中 进行 交易 并 非 直接 调用 智能 合约 图 数 ， 而 是 先 调用 以 太 坊 的 接口 间 
接 调 用 智能 合约 的 函数 。 

此 外 ， 无 论 是 sendTransaction 还 是 sndRawTransaction， 在 调用 成 功 后 ， 以 太 坊 都 会 直接 返回 
一 个 交易 哈 硕 值 〈 全 称 是 “Transaction Hash" , fj txHash). 。 注 意 是 直接 返回 ， 无 须 异 步 等 符 ， 
但 此 时 还 不 能 确定 交易 是 否 成 功 。 
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2.10.3 ”交易 参数 的 说 明 


上 一 节 中 我 们 认识 了 sendRawTransaction 中 的 两 个 参数 ， 即 data 和 to。 除 这 两 个 参数 之 外 ， 
在 以 太 坊 的 交易 接口 文档 中 ，RPC 接口 sendTransaction 和 sendRawTransaction 的 参数 还 有 很 多 ， 
但 其 参数 的 个 数 是 一 样 的 ， 在 这 些 参数 中 ， 地 址 值 类 型 的 参数 都 是 以 太 坊 的 合法 地 址 。 

图 2-51 所 示 是 以 太 坊 交易 接口 文档 关于 RPC 接口 sendTransaction 和 sendRawTransaction 的 
参数 说 明 。 


e from - String|Number : The address for the sending account. Uses the 
web3.eth.defaultAccount property, if not specified. Or an address or index of a local wallet 
in web3.eth.accounts.wallet. 

e to - String : (optional) The destination address of the message, left undefined for a 
contract-creation transaction. 

e value - Number|String|B8N|BigNumber : (optional) The value transferred for the transaction in 
wei, also the endowment if it's a contract-creation transaction. 


e gas - Number : (optional, default: To-Be-Determined) The amount of gas to use for the 


transaction (unused gas is refunded). 

e gasPrice - Number|String|BN|BigNumber : (optional) The price of gas for this transaction in wei, 
defaults to web3.eth.gasPrice. 

e data - String : (optional) Either a ABI byte string containing the data of the function call on 
a contract, or in the case of a contract-creation transaction the initialisation code. 

e nonce - Number : (optional) Integer of a nonce. This allows to overwrite your own pending 


transactions that use the same nonce. 


2-51 以太 坊 交 易 函 数 的 参数 
下 面 我 们 再 来 详细 认识 一 下 各 个 参数 。 


from: 代表 从 哪个 地 址 发 起 交易 ， 即 当前 的 这 笔 交 易 由 谁 发 出 。 要 注意 的 是 ， 如 果 交 易 的 to 
是 智能 合约 的 地 址 ， 那 么 合约 代码 中 的 “msg.sender” 变 量 代 表 的 就 是 这 个 from 地 址 。 

to: 代表 当前 交易 的 接收 地 址 。 注 意 ， 这 个 接收 地 址 不 能 理解 为 收 球 者 地 址 ， 因 为 to 的 取 值 
存在 下 面 3 种 情况 : 


(D 智能 合约 的 地 址 。 
(2) 普通 以 太 坊 用 户 的 钱包 地 址 。 
(3) 取 衬 值 的 时 候 ， 代 表 当 前 的 交易 是 创建 智能 合约 的 交易 。 


当 to 是 第 一 种 情况 的 时 候 ， 当 前 所 发 送 的 交易 将 会 交 给 对 应 的 智能 合约 处 理 ， 原 理 和 之 前 谈 
到 的 ERC20 代 币 转账 相同 。 所 以 ， 在 进行 ERC20 代 币 转账 时 ，to 应 该 是 智能 合约 的 地 址 。 

当 to 是 第 二 种 情况 的 时 候 ， 就 是 ETH 转账 ， 代 表 把 ETH 以 太 坊 转 给 哪个 地 址 。 

第 三 种 to 为 宇 的 情况 ， 代 表 当 前 的 交易 是 部 普 智 能 合约 到 链 上 的 交易 。 

value: 转账 的 数值 。 请 注意 ， 这 个 值 在 使 用 sendRawTransaction 进行 ERC20 代 币 转账 时 应 该 
是 0. 在 ERC20 代 币 转账 时 , 所 要 转账 的 值 的 多 少 是 定义 在 data 参数 中 的 。 在 使 用 sendTransaction 
HEIT ETH 转账 时 ，value 必须 有 值 ， 且 value 还 是 乘 上 了 105 次 方形 式 的 大 数值 。 

当 使 用 sendRawTransaction 进行 以 太 坊 ETH 转账 交易 时 ， 要 做 到 下 面 3 点 : 
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(1) to 应 该 对 应 收 革 钱包 的 以 太 坊 地 址 。 
(2) value 对 应 的 是 ETH 数值 ， 不 是 0。 
(3) data Z2 Jr B. 


只 有 满足 这 3 个 条 件 ，sendRawTransaction 进行 的 交易 操作 就 是 以 太 坊 ETH 转账 。 

gas: 这 个 gas 参数 就 是 gasLimit, 但 是 请 不 要 忘记 , 在 最 终 交 易 成 功 时 真实 使 用 的 是 GasUsed。 
交易 成 功 时 多 出 的 燃料 费 会 返回 ， 所 谓 多 出 的 燃料 费 就 是 (GasLimit - GasUsed) X GasPrice 部 分 。 

gasPrice 该 参数 标明 每 一 笔 gas 价值 是 多 少 wei，ETH 与 wei 的 换算 关系 前 文 已 有 讲述 。 所 
以 最 终 消耗 的 燃料 费 应 该 满足 gas X gasPrice 三 gasUsedX gasPrice， 单 位 是 wei. 

nonce: 就 是 交易 序列 号 。 

data: 这 是 一 个 很 重要 的 参数 ， 既 用 于 交易 接口 ， 又 用 在 “eth call” P. FHL ERC20 代 币 
转账 为 例 讲解 该 参数 的 含义 及 使 用 。 

首先 介绍 data 的 格式 ，data 的 格式 须 满 足下 面 几 点 : 


(OD 十 六 进 制 格式 ， 例 如 : 
0x70a08231000000000000000000000000021af430a036887cb0cfb7083b220f64bb3f8ed8 


(2) 前 10 个 字符 ， 包 含 0x， 是 methodId， 它 的 生成 方式 比较 复杂 ， 是 由 对 应 的 合约 图 数 的 
名 称 经 过 签名 后 ， 再 通过 Keccak256 加 密 取 特定 数量 的 字 节 ， 然 后 转 为 十 六 进 制 得 出 。 以 下 是 以 太 
坊 版 本 标准 生成 methodId 的 代码 : 

func (method Method) Id() []byte { 

return crypto.Keccak256([]byte (method.Sig()))[:4] 

) 

对 于 常见 的 函数 其 对 应 的 methodId， 有 下 面 的 两 种 : 

e 查询 余额 的 balanceOf 是 0x70a308231., 

e 转账 transfer 的 是 Oxa9059cbb. 


(3) 前 10 个 之 后 的 字符 ， 满 足下 面 的 条 件 : 
代表 的 是 智能 合约 中 函数 的 参数 。 
排序 方式 按照 合约 函数 参数 的 顺序 排列 。 
十 六 进 制 的 形式 。 
不 允许 有 0x， 即 先 转 成 十 六 进 制 形 式 再 去 掉 0x 字符 。 
去 掉 0x 后 ， 每 个 参数 字符 个 数 是 64. 


假设 一 份 智 能 合约 的 transfer 函数 的 入 参 是 两 个 整 型 ， 其 原形 是 transfer(uint a,uint b)， 那 么 此 
时 如 果 要 调用 这 份 合 约 的 transfer 负数， 那么 data 的 格式 应 该 是 : 

methodId + X + Y 

其 中 ,X Rl YDA al b EH f Ox 前 置 字 和 人 符 的 十 六 进 制 形 式 , HF transfer f] methodId 
是 0xa9059cbb， 当 a=1、b=2 的 时 候 ，data 就 是 下 面 的 形式 : 
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0xa9059cbb0000000000000000000000000000000000000000000000000000000100000000 
000000000000000000000000000000000000000000000002 


共 包 括 以 下 3 部 分 : 


(1) 0xa9059cbb 
(2) 00000000000000000000000000000000000000000000000000000001 
(3) 00000000000000000000000000000000000000000000000000000002 


以 上 就 是 以 太 坊 交易 函数 接口 参数 的 详细 说 明 。 请 注意 ， 在 实际 使 用 时 ， 由 于 第 三 方 库 的 封 
装 等 原因 ， 可 能 在 使 用 这 些 库 的 时 候 不 需要 传 这 么 多 参数 , 但 是 无 论 传 哪个 参数 ， 其 含义 是 不 会 变 
的 。 

下 和 耐 是 以 太 坊 geth 程序 在 ETH 转账 时 的 控制 台 命 令 ， 注 意 最 少 要 输入 3 个 参数 : 


eth.sendTransaction(([from:"0x...",to:"0x...",value:3]) 


2.10.4 ”交易 方法 的 真实 合 》 


在 上 面 一 节 中 ， 我 们 已 经 充分 认识 了 sendTransaction 和 sendRawTransaction 这 两 个 以 太 坊 发 
起 交易 接口 的 作用 和 入 参 。 我 们 要 认 清 的 一 个 事实 是 ， 上 面 的 两 个 交易 接口 所 指 的 “交易 ”代表 的 
不 仅仅 是 代 币 的 转移 ,还 代表 以 交易 的 形式 访问 智能 合约 的 一 个 公有 图 数 , 被 访问 函数 所 产生 的 变 
化 会 被 记录 到 区 块 数据 内 ， 而 控制 访问 函数 的 方式 是 通过 入 参 data 来 实现 的 。 

这 是 什么 意思 呢 ? 意思 就 是 , 在 调用 sendRawTransaction 发 起 以 太 坊 交易 时 , 如 果 所 传 参数 中 
的 data 是 methodId， 而 不 是 transfer， 将 不 会 实现 代 币 转移 ， 即 无 法 达到 代 币 转账 的 目的 ， 而 其 达 
成 的 效果 最 终 由 智能 合约 函数 所 定义 的 代码 来 决定 。 

为 什么 是 sendRawTransaction 而 不 是 sendTransaction? 因为 sendTransaction 已 经 被 以 太 坊 源码 
封装 好 了 ， 它 只 能 用 来 转账 以 太 坊 ETH， 本 质 上 和 sendRawTransaction 是 一 样 的 ， 被 封装 好 了 的 
sendTransaction， 此 时 它 的 data 被 设置 成 了 发 起 交易 的 附属 信息 ， 类 似 于 备注 。 

下 面 再 通过 一 个 例子 来 前 述 上 述 内 容 。 假 设 智能 合约 A 中 定义 了 一 个 函数 ,其 名 称 是 setName, 
这 个 图 数 的 功能 是 设置 名 称 ， 假 设 此 时 setName 的 methodId 是 0xabc， 入 参 是 一 个 字符 串 。 那 么 当 
我 们 使 用 sendRaw Transaction 调用 智能 合约 A 中 的 setName 函数 时 , data 参数 就 要 设置 为 与 setName 
相关 的 数据 ， 竺 发 起 交易 时 ， 这 笔 交 易 被 矿工 成 功 打包 进 区 块 中 之 后 ， 名 称 便 成 功 地 被 设置 了 ， 且 
结果 也 会 被 记录 到 这 笔 交 易 所 打包 进 了 的 区 块 中 一 一 被 持久 化 到 节点 中 的 “ 键 - 值 对 ”<k,v> 数 据 库 
中 。 此 时 ， 这 笔 交 易 只 是 调用 了 合约 中 的 setName 函数 ， 仅 达到 了 一 个 设置 名 称 的 目的 ， 并 没有 发 
生 任何 的 代 币 转账 ， 但 我 们 也 把 这 一 次 调用 看 作 是 一 次 交易 。 

下 面 是 我 们 在 实际 开发 中 使 用 sendRawTransaction 进行 交易 时 经 常用 到 的 调用 方法 的 名 称 : 

e 转账 ， 此 时 data 中 转化 后 的 methodId 原型 对 应 的 是 transfer. 

e 授权 ， 此 时 data 中 转化 后 的 methodId 原型 对 应 的 是 approve. 
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2.10.5 ”区 多 的 状态 


当 我 们 使 用 sendTransaction 或 sendRawTransaction 将 一 笔 交 易 提交 到 以 太 坊 ， 并 得 到 了 以 太 
坊 返 回 的 哈 硕 值 后, 这 时 我 们 并 不 能 判断 这 笔 交 易 的 最 终结 果 是 成 功 还 是 失败 。 请 记 住 ， 获 取 了 哈 
布什 只 能 代表 以 太 坊 成 功 地 接收 了 这 笔 交 易 的 请 求 ， 不 能 代表 交易 最 终 是 否 成 功 。 

在 交易 被 以 太 坊 成 功 接收 后 ， 它 会 经 历 图 2-52 所 示 的 生命 周期 。 


发 起 交易 请 求 


数据 校 验 通 过 


， 


交易 被 放置 入 队列 (queue), # 
返回 txHash 给 客户 端 


| 


交易 等 待 被 放 入 等 此 时 查询 txHash 
待 列表 (pending) | — 


， 


交易 被 放 入 等 待 列表 此 时 查询 txHash 
， 等 待 区 块 打包 为 pending 状态 


| 


区 块 打包 了 这 条 交易 


/ N 查询 txHash 


此 时 
区 块 不 是 分 叉 块 为 failed 状态 


， 


交易 被 从 等 待 列 表 
中 移 除 


， 


成 功 
2-52 ”一 次 交易 从 发 送 到 彻底 成 功 的 生命 周期 


图 2-52 中 的 txHash 就 是 交易 的 哈 希 值 ， 可 以 看 出 ,一 次 交易 在 成 功 提 交 到 以 太 坊 后 共有 4 种 
状态 ， 分 别 是 : 
e Unknown (未 知 状态 ) 。 还 没 被 放 入 到 txPool 以 太 坊 交易 池 中 ， 这 个 时 候 如 果 用 区 块 链 浏 览 
器 查询 这 个 txHash， 就 会 发 现 无 任何 信息 。 
e Pending (等 待 或 挂 起 状态 ) 。 这 个 状态 是 最 常见 的 ， 是 交易 成 功 的 必 经 状态 ， 此 时 我 们 用 区 
块 链 浏览 器 查询 ， 能 查询 出 部 分 交易 信息 。 注 意 是 部 分 交易 信息 ， 例 如 图 2-53 所 示 的 查询 结 
果 并 没有 显示 区 块 号 信息 ， 即 “block height” (区 块 高 度 ) 。 


Overview 


Transaction Hash: 


Status 


Block 


Time Last Seon 


Fstimated Confirmation Duration 


From: 
To 


Token Transfer: 


Value 


Max Txn Cost/Fee 


2-53 
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0xd4778c08d17c9a69da6bde578eí66d14e764851ec5dí[3581128640e40fí0d67a (Di 


区 块 高 度 block height 此 时 世 是 未 知 的 


2: 00 days 00 hr 25 min 13 secs ago (May-16-2019 05 43:56 AM) 


- 15 mins : 30 secs | FB 


0xec00a9aa89517ba233eÜ0ebBaa94ac39deec60d99 (0 


0xb8c77482e45f1144de1745152c74426c631bdd52 (Binance Token) [Ñ 


+ Pending Transfer to 一 0x57b7fade91c... For 19 © ERC-20 


0 Ether ($0.000000) 


0.00092 Ether (S0.24) 


用 区 块 链 浏览 器 得 询 Pending (等 符 或 挂 起 ) 状态 下 的 交易 时 所 看 到 的 信息 


e Success (成 功 状态 ) 。 代 表 交 易 成 功 。 
e Failed (失败 状态 ) 。 注 意 ， 在 交易 失败 时 ， 也 能 够 查询 出 该 交易 的 相关 信息 ， 例 如 区 块 高 度 


等 ， 如 图 2-54 所 示 。 


Transaction Information QG € 


TxHash 
TxReceipt Status: 
Block Height 
TimeStamp: 
From: 


To 


Value 


Gas Limit 


Gas Used By Transaction: 


Gas Price 
Actual Tx Cost/Fee: 
Nonce & (Position) 


Input Data: 


N 0x3dddíca7745415fa837c89c185bcb049b9badcc15c60ec34806 1a6056cc871f9 


Fail 
33993096 (134612 Block Confirmations) 
21 days 22 hrs ago (Sep-25-2018 05:22. 28 PM +UTC) 
)xa3e2e12a34267bce5d45e6b71a549f162c7194b67 1 
Contract 0x78021abd9b05f0456cb9db95a846c302c34f8b8d 
Warning! Error Encounter during Contract Execution [Reverted] 
Á ERC-20 Token Transfer Error (Unable to locale Corresponding Transter Event Logs), Che 
0 Ether ($0.00) 
100000 
22641 
0.000000008 Ether (8 Gwei) 


0.000181128 Ether ($0.04) 


703 | (87) 


Function: transfer (address to uint256 value) 
Funet fer (add uint256 i 


MethodID: Oxa9059cbb 


[0]: Q0000000000000000000000000009000000000000000000000000000000000000 
[ ]: 00000000000000000000000000000000000000000000044 fb 7 c28018c 9200000 


图 2-54 ”失败 状态 的 交易 信息 
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因为 以 太 坊 交易 池 的 大 小 是 有 限制 的 ， 所 以 第 第 会 造成 一 些 交 易 订 单 只 是 处 于 被 放置 到 交易 
池 ， 尚 未 被 交易 的 状态 ， 该 状态 称 为 “Unknown” (未 知 状态 ) 。 造 成 这 种 情况 的 原因 是 ， 矿 工 在 
交易 池 中 的 交易 订单 的 排序 算法 受 GasPrice 的 影响 ， 也 就 是 说 ， 如 果 交 易 订 单 A 此 刻 排 在 第 三 ， 
刚好 有 新 的 订单 B HKT., H B 的 GasPrice 很 高 ， 那 么 订单 A 就 有 可 能 被 排 后 。 根 据 这 个 特点 ， 
如 果 长 时 间 地 出 现 这 种 排队 的 情况 ， 就 有 可 能 导致 某 个 低 GasPrice 的 订单 一 直 处 于 Pending CS 
或 挂 起 ) 状态 ， 述 返 不 被 矿工 打包 ， 从 而 会 出 现 有 些 等 待 状态 的 交易 订单 被 “ 挂 起 ” 几 天 甚至 更 久 


时 间 的 情况 。 
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Fail 的 失败 情况 一 般 发 生 在 和 智能 合约 交互 的 相关 交易 中 , 交易 的 错误 由 合约 的 代码 抛 出 ， 比 
如 参数 错误 等 原因 。 


2.10.6 ”交易 被 打包 


上 面 我 们 认识 了 交易 从 发 送 到 添加 进 以 太 坊 交易 订单 池 的 过 程 。 那 么 被 添加 到 了 交易 池 中 的 
交易 最 终 又 是 怎样 被 打包 进 区 块 里 面 的 呢 ? 下 面 我 们 从 如 图 2-55 所 示 的 流程 图 来 认识 一 下 。 


两 边 流程 的 
进程 日 不 影响 
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监听 到 新 区 块 事件 ， 
移 除 新 区 快 对 应 
池 中 的 交易 
打包 校 验 到 
控 出 的 区 块 中 


该 区 块 达到 一 定 
的 区 块 确认 数 


2-55 ”交易 从 发 送 到 添加 进 以 太 坊 交易 订单 池 的 过 程 


图 2-55 便 是 以 太 坊 订单 池 中 的 交易 订单 被 添加 到 池 中 之 后 ， 再 被 打包 到 区 块 中 直至 被 从 订单 
池 移 除 的 一 个 大 致 的 生命 流程 图 。 

其 中 对 于 矿工 打包 交易 时 “再 次 校 验 交 易 ” 的 步骤 ， 内 部 拥有 一 次 交易 燃料 费 的 计 复 步 又 ， 
这 是 在 前 面 “ 燃 料 费 ”一 节 中 ，EVM (虚拟 机 〉 计算 燃料 费 的 流程 。 
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2.11 “AER RA 


和 以 太 坊 交易 一 样 ， 以 太 坊 的 “ 代 币 ” (Token) 余额 并 非 仅 仅 局 限于 代 币 ， 例 如 ， 以 太 坊 的 
“以 太 猎 ”应 用 , 我们 基于 它 的 智能 合约 查询 余额 时 ,得 到 的 结果 代表 的 就 是 “该 地 址 拥有 多 少 只 
猫 ”。 为 了 便于 文字 表述 ， 我 们 还 是 称 Token 为 代 币 。 

以 太 坊 的 “ 代 币 ”余额 ， 主 要 有 下 面 的 两 种 类 型 : 


(1) ETH 余额 。 

(2) 智能 合约 代码 定义 的 对 象 的 拥有 数 。 

不 同 的 “ 代 币 ”类 型 ， 其 查询 余额 的 方式 也 不 同 。 以 太 坊 “ 代 币 ”余额 一 般 是 通过 东 个 以 太 
坊 地 址 来 查询 的 ， 主 要 有 以 下 3 种 查询 方式 : 


(1) 通过 调用 以 太 坊 的 接口 查询 。 

(2) 使 用 以 太 坊 浏览 器 进行 查询 。 

(3) 使 用 以 太 坊 钱包 App 查询 。 

第 二 、 三 种 方式 的 本 质 也 是 通过 调用 以 太 坊 接口 进行 查询 ， 不 同 之 处 在 于 这 两 种 查询 帮 我 们 
封装 好 了 代码 层面 的 东西 ， 查 询 操作 可 直接 在 应 用 层 进行 。 

查询 余额 的 接口 也 分 为 两 类 ， 分 别 是 : 


(1) 以 太 坊 的 ETH 余额 查询 接口 “eth_getBalance”。 
(2) 以 太 坊 的 “eth call” 接 口 。 使 用 “eth call” 访 问 智能 合约 提供 的 余额 查询 函数 来 达到 查 
询 的 目的 ， 例 如 ERC20 标准 提供 了 “balanceOf” 妙 数 。 


这 两 类 接口 有 很 大 的 区 别 。 针对 ETH 查询 ， 以 太 坊 提供 了 一 个 专门 的 接口 “eth_getBalance”， 
就 像 sendTransaction 和 sendRawTransaction 一 样 ， 都 提供 了 一 个 专门 的 接口 。 而 其 他 的 非 ETH 
的 “ 代 币 ”余额 查询 ,包含 ERC20 代 币 和 非 代 币 资产 ,只 能 调用 以 太 坊 提供 的 一 个 万 能 接口 “eth_call” 
来 查询， 且 在 查询 时 必须 传 入 正确 的 data 参数 。 

如 图 2-56 所 示 是 ERC20 代 币 的 查询 请 求 示 例 。 

请 留意 图 2-57 中 的 data, 它 的 前 10 个 字符 就 是 我 们 在 “以太 坊 交易 ”一 节 中 讲 到 的 ”balanceOf” 
的 “methodId”， 后 和 面 跟随 的 参数 就 是 我 们 所 要 查询 余额 的 以 太 坊 地 址 。 

图 2-57 的 “method” 键 对 应 的 值 是 “eth call”， 它 的 详细 介绍 可 参考 “重要 接口 的 含义 详解 ” 
一 节 ， 目 前 智能 合约 的 非 转账 类 函数 都 能 通过 这 个 接口 进行 调用 ， 只 需要 把 合约 中 对 应 函数 的 

“methodId” 标 明正 确 和 入 参 设置 到 data 中 即 可 。 

为 什么 是 合约 中 的 非 转 账 类 函数 呢 ? 如 果 我 们 在 实际 的 开发 中 使 用 eth call 来 调用 合约 中 的 
transfer 转账 函数 会 怎样 呢 ? 

答案 是 以 太 坊 的 eth call 用 来 调用 智能 合约 的 transfer 函数 ， 既 不 报错 也 不 会 实现 真正 的 数值 
转账 ， 最 终 返 回 的 结果 是 一 个 “0x 字符 串 ”。 
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-+b p | m SE 

H AXI] BEIDE 

1) Body e 

form-data x-Www-form-urlencoded 


* ( 
2 "jsonrpc": "2.0", 
"method": "eth call", 


"from": "0x021af4303036887cb0cfb7083b220f64bb3f8ed8" , 

"to": "0x107eff256b79f45723c0499edd1120c3034d73256", 

"gas": "exe", 

"gasPrice": "exe", 

"value": "6x6", 

": "0x702082310000000000000000000000000212f4302036887cb0cf07083b220f64bb3f8ed8", 
'« "exe" 


Pretty 
EE 1 
2 "jsonrpc": "2.0", 
3 "id": 23, 

"result": "@x000000000000000000000000900000000009090000009090000909000000009090909090009090" 


2-56 ”使 用 Postman 工具 查询 代 币 的 余额 
2.12 URHAN 


以 太 坊 浏览 器 是 区 块 链 浏览 占 中 的 一 类 。 可 以 这 样 说 ， 区 块 链 是 一 个 大 的 概念 ， 区 块 链 浏览 
器 包含 比特 币 浏 览 器 和 以 太 坊 浏览 器 等 。 

我 们 之 前 介绍 的 余额 得 询 方式 是 面 癌 开发 人 员 的 ， 对 于 普通 用 户 来 说 ， 要 进行 以 太 坊 相关 信 
a (包含 代 币 余额 ) 的 得 询 ， 一 般 使 用 的 都 是 以 太 坊 浏览 器 。 以 太 坊 浏览 器 其 实 就 是 一 个 网 页 应 用 
程序 ， 也 就 是 对 网 站 访问 ， 其 内 部 的 得 询 功能 是 通过 封闭 好 了 的 以 太 坊 接口 实现 的 。 目 前 最 为 权威 
并 出 名 的 以 太 坊 浏览 器 是 “etherscan.io”， 官 方 网 站 是 https:Wetherscan.io/ 。 

“etherscan.io ”几乎 具备 了 以 太 坊 链 上 所 有 数据 信息 的 得 询 功 能 ， 同 时 还 提供 了 最 新 区 块 生 成 
记录 及 其 最 新 交易 的 信息 列表 ， 如 图 2-57 所 示 。 

在 上 述 区 块 链 浏览 器 的 主页 中 ， 右 上 角 的 输入 框 支持 以 下 各 项 查询 功能 : 
钱包 地 址 的 查询 ， 需 要 输入 要 查询 的 以 太 坊 地 址 ( Address) . 
交易 详情 的 查询 ， 需 要 输入 要 查询 交易 的 txHash. 
区 块 信息 的 查询 ， 需 要 输入 要 查询 的 区 块 的 哈 布 值 。 
代 币 的 信息 查询 ， 需 要 输入 要 查询 代 币 的 地 址 ， 它 也 是 一 个 以 太 坊 地 址 。 
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i earch by Address / Txhash ock / Token 
MEtherscan | T — 
A HOME 


BLOCKCHAIN OKENS RESOURCES 


Sponscred Q Crypto.com - Crypto Invest: Democratizing Quant Trading - start your automated trading portfolio wih $20 min - live now! 


MARKET CAP OF $20 807 BILLION Erhereum Transaction History in 14 days 
$202.42 @ 0.03125 BTC/ETH í 


LAST BLOCK TRANSACTIONS 
6581313 (4o 331.43 M 


Hash Rate Network Difficulty 
246,260 B6 GHA 3,133 21 TH 


&» Blocks 


Mined By 
Block 6581313 


>28 ence ago 


170 txns 


Mined By M 
50 tans 


Block 6581312 


»42 secs ago 


Mined By ! 
Block 6581311 


»47 sacs ago 


84 txna 


图 2-57 Etherscan 浏览 器 主页 的 最 新 区 块 生成 记录 


如 图 2-58 所 示 是 地 址 为 “0x78021abd9b06f0456cb9db95a846c302c34f8b8d” 的 代 币 查询 结果 图 。 


(fo Etherscan Home Blockchain v Tokens ~ Resources v More ~ € Sign In 


Feature Tip: Track historical data points of any address with the new analytics module! 


Ethereum Blockchain Explorer Quick inks: ERC-20 Tokens ERC-721 Tokens 


All Filters ~ | 0x78021abd9b06f0456cb9db95a846c302c34f8b8d | 在 这 里 输入 要 查询 的 地 址 点 击 搜索 Search 


ETHER PRICE æ; LATEST BLOCK TRANSACTIONS ETHEREUM TRANSACTION HISTORY IN 
*' $262.81 @ 0.03271 BTC («13 719) 7769696 (1323) 447.56 M (103 TPS) AYS 


| 000k 


MARKET CA DIFFICULTY HASH RATE 


| 7 
$27.881 Billion 好 2037.25 TH 163,583.12 GH/s 


e Etherscan AIl Filters ~ Search by Address / Txn Hash / Block / 


Eth: $262.06 (+13.39%) Home Blockchain w [okens v Resources v More v 6 Sign in 


B Contract[ox78021ABD9bO6f0456cB9DB95a846C302c34febeD| 0 z cin Loan v 


Wes, 所 查询 的 地 址 的 值 


Etherscan - Sponsored slots available. Book your slot here! 
Contract Overview More Info 
Balance: © My Name Tag : Not Available, login to update 


Ether Value: S0 Contract Creator 0x28de3ba33a.. attxn Ox4fci1c491cfob 


$36,096 58 EJ Token Tracker: E3 CDCC (CDCC) 


Transactions Erc20 Token Txns Code 9 Read Contract Write Contract Events Analytics | New | Comments 
IF Latest 25 from a total of 16,850 transactions 
Txn Hash Block Age From To Value [Txn Fee] 
0x6ec56475123.. 7761331 1 day 7 hrs ago 0x081cdf82222... IN E 0x78021abd9pb... 0 Ether 


Oxf89200cf78a7 .. 


图 2-58 KREDI X38 Er TIU] DNI HUE Si 15 9 T 
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此 外 ， 还 有 我 们 在 开发 过 程 中 经 第 会 进行 交易 哈 希 值 的 查询 ， 该 查询 显示 的 页 面 和 在 “交易 
的 状态 ”一 节 中 的 图 2.53 和 图 2.54 一 样 。 一 般 来 说 ， 碍 询 交 易 哈 希 值 的 目的 主要 是 为 了 了 解 交 易 
的 状态 ， 比 如 观察 交易 是 等 待 (Pending) 被 打包 还 是 已 经 成 功 了 (Success) 等 。 


2.12.4 区 块 链 浏览 器 访问 合约 函数 


上 面 一 节 提 到 可 以 在 以 太 坊 浏览 器 中 查询 代 币 余额 ， 这 其 实 只 是 调用 合约 代码 函数 的 一 种 方 
式 。 如果 我 们 要 查询 的 是 以 太 坊 , 那么 直接 在 浏览 器 的 输入 杠 中 输入 要 得 询 的 钱包 地 址 即 可 。 例 如， 
在 图 2-59 中 ,左上 角 的 “Balance ”字段 对 应 的 就 是 当前 被 查询 地 址 中 以 太 坊 ETH 的 数值 ( 即 余 额 ) ， 
单位 是 ETH. 


Ø Address 0x39d650D5B1bF74eC5790345844D54d4023F3Da39 © 2 


air - [he fastest tech and the best design, only with FunFair's groundbreaking gaming dApps. Learn More 
More Info 
balance 是 以 太 坊 ETH 余额 栏 


0.0019191836 Ether © My Name Tag Not Available, login to update 


Ether Value $0.51 (@ $263.58/ETH) 


Value 
07 1 day 6 hrs ago O0x398d850d5b1 OUT [3 0xb5180a8252 0 Ether 


77161453 1 day 6 hrs ago 0x7b5a45536 1 Ox39d650d5b1 0.002 Ether 


7759115  1day 15 hrs ago 0x39d650d5b1 0x755a45536 0.01875634 Ether — 0.00033578 


2-59 区 块 链 浏 览 器 查看 以 太 坊 地 址 的 ETH 余额 


请 注意 ， 上 面 是 查询 ETH 余额 的 方式 ， 如 果 要 查询 的 不 是 ETH 的 余额 ， 而 是 菜 一 种 ERC20 
代 币 的 余额 ， 那 么 就 需要 进入 对 应 的 ERC20 代 币 界面 去 得 询 ， 这 是 什么 意思 呢 ? 例如， 要 查询 某 
个 钱包 地 址 所 拥有 ERC20 代 币 CDCC 的 个 数 是 多 少 ， 首 先 要 找到 这 个 ERC20 代 币 的 合约 地 址 ， 
从 以 太 坊 浏览 器 中 查询 该 地 址 , 进入 到 该 代 币 的 详情 页 和 面 后 才能 进行 下 一 步 的 查询 , 这 里 的 CDCC 
是 这 个 代 币 的 Symbol， 意思 是 符号 。 下 面 给 出 查询 步骤 : 
CD 找 出 要 查询 的 ERC20 代 币 的 合约 地 址 ， 例 如 : 
0x78021abd9b06f0456cb9db95a846c302c34f8b8d 


(2) 从 以 太 坊 浏览 器 中 查询 上 和 面 的 地 址 ， 进 入 到 该 代 币 详情 页 ， 如 图 2-60 所 示 。 
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B Contract 0x78021ABD9b06f0456cB9DB95a2846C302c34f8b8D © se Farn Interest 


Feature Tip: Ethereum charts & statistics at your fingertip. Learn More! 
Contract Overview More Info 
Balance © My Name Tag : Not Available, login to update 


Token Tracker 栏 中 
Ether Value: $0 显示 了 代 币 的 名 称 Ni Contract Creator: 0x28de3ba33a... at txn Ox4f 


Token: $36,096.58 EJ v |t: Token Tracker: ED CDCC (CDCC) 


Transactions Erc20 Token Txns Code 9 Read Contract Write Contract Events Analytics New 


图 2-60 用 区 块 链 浏览 器 查看 ERC20 代 币 
(3) 单 击 界 面 上 的 “Read Contract” 按 钮 ， 从 显示 出 的 内 容 中 可 以 直观 地 看 到 之 前 在 ERC20 
标准 一 节 中 所 认识 的 一 些 智 能 合约 中 的 字段 变量 ， 例 如 name、totalSupply 等 ， 如 图 2-61 所 示 。 
@ Contract 0x78021ABD9b06f0456cB9DB95a846C302c34f8b8D © 
Feature Tip: Ethereum charts & statistics at your fingertip. Learn More! 
Contract Overview More Info 
Balance 0 Ether © My Name Tag Not Available, login to update 


Ether Value $0 Contract Creator: 0x28de3ba33a... at txn Ox4fc1c49 14 


Token $36,090.58 EJ + Token Tracker EG CDCC (CDCC) 


Transactions Erc20 Token Txns Code e Read Contract Write Contract Events Analytics | New | Com 


局 Read Contract Information 


1. reserveSupply o 


0 uint256 — ”点击 Read Contract 按钮 查看 合约 的 基础 信息 
D 


CDCC string 


图 2-61 用 区 块 链 浏 览 器 查看 ERC2 合约 标准 的 字段 


(4) 在 “Read Contract ”页面 显示 区 域 中 , 回 下 滑动 鼠标 , 直到 看 见 ERC20 标准 中 的 “balanceOf” 
代 币 余额 查询 函数 ， 如 图 2-62 所 示 。 
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T. balanceOf 


<input> (address) 


合约 中 得 询 对 应 代 币 余额 的 函数 


8. owner 


0x28de3ba33a322a550244b48e9646f1c95b7b6afd address 


2-62 ”在 区 块 链 浏览 器 中 调用 ERC20 标准 合约 的 余额 函数 


(5) 在 “balanceOf ”函数 下 面 的 输入 杠 中 输入 要 碍 询 的 钱包 地 址 ， 然 后 单 击 “Query” 按 钮 ， 
就 能 对 此 钱包 地 址 拥有 多 少 个 CDCC 代 币 余额 进行 查询 ， 如 图 2-63 所 示 。 


T. balanceOf 


input» (address) 


0xc30efec25328b698533331df20ed7d65bc218e47 


M. 


输入 要 查询 的 地 址 ， 点 击 
Pd Query 按钮 ， 看 到 返回 的 结果 值 


[ balanceOf method Response | 


2-63 查询 CDCC 代 币 余额 
在 上 面 最 终 查 询 出 的 余额 值 是 一 个 乘 上 了 当前 代 币 的 1092! 次 方 数值 的 值 。 如 果 要 得 出 实际 
拥有 的 以 “个 ”为 单位 的 代 币 值 ， 记 得 要 将 这 个 大 数值 除 以 10%ema， 此 外 这 个 decimal 的 值 也 是 能 
E “Read Contract" 页 面 看 到 的 。 如 网 2-64 Pr. 


2-64 查看 decimal 的 值 
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上 面 通过 在 以 太 坊 浏 虎 天 进行 代 币 余 额 查 询 的 一 个 例子 ， 来 说 明了 如 何在 以 太 坊 浏览 需 中 “调用 
合约 函数 ”。 除 了 余额 的 查询 外 ， 还 可 以 查询 授权 值 等 ， 它 们 的 操作 方式 大 同 小 寞 ， 如 图 2-65 所 示 。 


11. allowance 


«input» (address) 


«input» (address 


«input» (address) 


2-65 ”在 区 块 链 浏览 器 调用 ERC20 标准 合约 的 授权 函数 


2.12.2 ”区 块 链 浏览 器 查看 交易 记录 


在 区 块 链 浏览 器 中 查看 交易 记录 也 是 一 项 基本 技能 ， 仍 然 以 “etherscan.io” 为 例 进 行 演示 。 在 
“etherscan.io” 主 页 的 搜索 输入 框 中 ， 输 入 想 要 查询 的 以 太 坊 地 址 进行 搜索 ， 就 能 进入 到 对 应 的 地 
址 主页 面 ， 如 图 2-66 所 示 。 


(f Etherscan iome Blockchain ~ Tokens v Resources v More v € Sign In 


Feature Tip: [rack historical data points of any address with the new analytics module! 


Ethereum Blockchain Explorer Quicklinks: ERC-20 Tokens ERC-721 Tokens 


All Filters ~ | 0x78021abd9506f0456cb9db95a846c302c34f8b8d | 在 这 里 输入 要 查询 的 地 址 点 击 Search 


ETHER PRICE 一 一 ATEST BLOCK TRANSACTIONS ETHEREUM TRANSACTION HISTORY IN 14 
+ 


" $262.81 @ 0.03271 BTC (+13.71%) 7769696 (13.2s) 447.56 M (10.3 TPS) DAYS 


| 000k 


MARKET CAP , JIFFICULTY HASH RAI 


f 
$27.881 Billion Ê 2,037.25 TH 163,583.12 GH'/s 


2-66 ”在 “etherscan.io” 主 页 输入 要 查询 的 以 太 坊 地 址 


例如 ， 要 查询 地 址 OXBObF3242eBED6525d256B5B32BD69C7EACc63F6F2 的 交易 记录 ， 在 进行 
搜索 后 可 以 看 到 交易 记录 的 列表 页 面 。 如 图 2-67 所 示 ， 可 以 选择 查看 具备 多 类 交易 的 交易 信息 项 。 

e 类 型 “Transactions” 对 应 的 是 以 太 坊 ETH 代 币 交易 的 交易 记录 。 

e 类 型 “Erc20 Token Txns” 代 表 的 是 “ERC20” 代 币 的 交易 项 ， 和 鼠标 单 击 即 可 进行 切换 。 

此 外 ， 如 果 还 有 其 他 类 型 的 “ 代 币 ”， 例 如 “ERC721” 类 型 的 交易 记录 ， 那 么 它 将 会 出 现在 
“Erc20 Token Txns” 按 钮 的 右边 ， 以 此 类 推 。 在 列表 中 ， 每 一 条 蓝 色 字体 都 可 以 用 鼠标 单 击 ， 我 
们 单 击 “TxHash” 列 下 的 每 笔 交 易 哈 希 值 ， 就 能 进入 到 被 单 击 交 易 所 对 应 的 详情 页 。 
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Eam Interest v 


Feature Tip: Enable advanced mode 
Overview More Info 
Balance: 94.357722951197266419 Ether (D My Name Tag Not Available, login to update 


Ether Value $14,403.71 (& $264 9&/ETH) 


Token $579.04 四 


Erc20 Token Txns Analytics | New | Comments 


IF Latest 25 from a total of 240 transactions 


每 一 条 就 是 交易 记录 ， 鼠 标点 击 任 一 条 ， 
可 以 进入 详情 页 面 


To Value 
7754992  À2days7 hrs ago 0x5e71809432 . Oxb0bf3242ebe.. 0.09 Ether 
[743456 4days 2 hrs ago 0xb2a48f542dc.. O0xb0bf3242ebe.. 2.995 Ether 


76866586 12 days 23 hrs ago Huobi 16 Oxb0bf3242ebe.. 1.995 Ether 


2.12.3 3E ETH 交易 记录 不 能 作为 资产 转账 成 功 的 依据 


对 于 非 ETH 交易 来 说 ， 一 般 大 家 都 会 以 为 如 果 一 笔 交 易 记 录 在 区 块 链 浏览 器 上 能 被 得 询 到 ， 
且 状 态 是 成 功 的 ， 就 认为 这 笔 交 易 背 后 所 转移 的 资产 也 就 到 账 了 。 

事实 上 ， 这 种 判断 是 错误 的 。 请 记 住 ， 区 块 链 浏览 器 的 非 ETH 交易 记录 不 能 作为 资产 转账 成 
功 的 依据 ! 

为 什么 呢 ? 

依然 以 “etherscan.io” 为 例 ， 在 上 一 节 中 ， 我 们 可 以 根据 一 个 以 太 坊 地 址 在 “etherscan.io” 上 
查询 到 与 它 相 关 的 交易 记录 。 那 么 “etherscan.io” 网 站 是 怎样 从 以 太 坊 区 块 链 上 获取 到 这 些 交 易 的 
呢 ? 答案 是 ，“etherscan.io” 上 的 非 ETH 代 币 的 交易 记录 都 是 通过 读 取 区 块 “Event log” CRF 
日 志 ) 数据 中 的 “Event” 得 到 的 ， 而 “Event” 是 由 我 们 编写 的 智能 合约 的 代码 生成 的 。 

在 ETH 的 交易 记录 中 并 没有 “Event log” 这 个 概念 ， 所 有 在 正规 区 块 链 浏览 器 中 看 到 的 ETH 
交易 记录 都 可 以 作为 ETH 交易 的 依据 。 

下 面 分 别 指 出 “Event” 相 关 的 几 个 技术 点 : 

e “Event” 是 开发 者 可 以 在 智能 合约 代码 中 随意 定义 并 在 函数 中 触发 的 事件 。 

e ”我们 可 以 在 智能 合约 代码 中 定义 “Transfer” 的 “Event” , 

e 只 要 被 记录 到 了 区 块 的 “Eventlog” 中 的 “Event” ， 就 能 被 区 块 遍历 器 读 取 . 

e 区 块 中 的 “Transfer Event” 会 被 “etherscan.io” 当 作 交易 记录 读 取 并 显示 。 

e 所 有 经 过 以 太 坊 “sendRawTransaction” 接 口 调用 触发 的 智能 合约 函数 ， 其 内 部 的 “Event” 

将 会 被 记录 到 区 块 的 “Event log” 中 ， 从 而 被 区 块 遍 历 器 读 取 。 下 面 举 个 例子 阐述 这 个 结论 。 


智能 合约 A 拥有 国 数 “func1”， 它 仅仅 触发 了 一 个 “Transfer” 的 “Event”， 而 没有 做 其 他 
的 操作 。 
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function funcl(address from,address to, uint256 value) public returns (bool 

success) { 
emit Transfer(msg.sender, to, value); 
return true; 

] 

如 果 此 时 我 们 使 用 “sendRawTransaction ”接口 调用 了 智能 合约 A 的 这 个 图 数 ， 就 会 造成 
“etherscan.io” 把 里 面 被 触发 的 “Transfer Event” 从 区 块 中 读 取 出 ， 然 后 当 作 一 笔 交 易 记 录 显 示 在 
“msg.sender” 地 址 所 对 应 的 交易 记录 页 面 中 ，“ from” 参 数 将 会 对 应 显示 到 网 页 页 面 的 “from” 
标签 中 ， 而 “_to” 就 是 收 球 人 的 地 址 标签 。 

但 是 ， 请 注意 ， 我 们 在 “Funcl1” 子 数 中 并 没有 添加 任何 的 资产 转移 代码 ， 例 如 添加 了 下 面 的 
合法 代码 : 

HO 


balances[_to] += _value; 


上 面 例 子 最 终 导 致 的 结果 是 ， 在 浏览 器 中 能 查看 到 交易 的 成 功 记 录 ， 但 是 却 没有 引发 真实 的 
“ 代 币 ”资产 转账 。 

如 果 我 们 不 采用 “sendRawTransaction ”接口 调用 智能 合约 A 的 这 个 图 数 ， 而 使 用 “eth_call” 
来 调用 ， 它 里 面 的 “Event” 将 不 会 被 记录 到 “Event log” 中 。 

那么 如 何 判断 一 笔 交 易 记 录 是 有 效 的 呢 ? 判断 一 笔 交 易 记 录 是 否 有 效 的 必要 条 件 是 : 

e 当前 交易 对 应 的 “Event” 是 可 以 被 查询 到 的 。 

e 到 对 应 的 智能 合约 中 碍 看 触发 “Event” 的 函数 代码 。 

e 保证 触发 “Event” 的 合约 函数 代码 是 没有 问题 的 , 有 明确 的 资产 转移 代码 , 例如 balances[_to] 


+= value 。 


上 述 判断 条 件 是 从 一 个 广义 的 角度 来 进行 的 ， 还 可 以 进一步 细 分 来 添加 其 他 的 判断 条 件 ， 例 
如 保证 合约 遵循 了 ERC 系列 标准 的 判断 条 件 ， 这 样 我 们 就 能 根据 标准 的 函数 名 称 查询 对 应 的 值 ， 
例如 “ERC20” 标 准 中 查询 余额 的 函数 ， 其 名 称 为 “balanceOf”。 

细 分 的 条 件 都 不 是 必要 的 ， 以 合约 的 标准 为 例 ， 它 本 喘 只 是 一 种 规范 ， 我 们 可 以 不 这 循 这 种 
规范 实现 自己 的 “ 代 币 ”合约 ， 查 询 余 额 的 函数 名 称 也 不 一 定 就 是 “balanceOf”， 也 可 以 定义 为 
“getBalance”， 只 要 能 正确 地 实现 余额 查询 功能 即 可 。 

回 到 我 们 上 和 面 的 示例 代码 中 ， 例 子 中 的 函数 触发 了 “Transfer Event”【〔 转 账 事件 ) 却 没 有 引 
起 真实 资产 转账 的 合约 代码 , 我 们 一 般 都 认定 为 是 有 代码 问题 的 智能 合约 。 而 目前 在 绝 大 部 分 流通 
的 “ 代 币 ”中 ， 智 能 合约 几乎 都 满足 凡是 触发 了 “Transfer Event” 的 函数 ， 其 内 部 必然 是 进行 了 资 
产 转 移 。 

还 有 ， 对 于 在 虚拟 资产 交易 所 中 可 以 进行 交易 的 “ERC20” 代 币 来 说 ， 它 们 的 智能 合约 代码 
都 已 被 交易 所 检查 过 ， 也 就 不 存在 我 们 上 面 所 举例 的 情况 。 


2.12.4 ”区 块 链 浏览 器 碍 看 智能 合约 的 代码 


在 上 一 节 中 ， 我 们 介绍 了 如 何 判 断 一 笔 交 易 记 录 的 有 效 性 一 一 我 们 只 需要 到 智能 合约 中 查看 
合约 是 否 触 发 了 “Transfer event” 图 数 代 人 码 即 可 得 出 结论 ， 在 区 块 链 浏 览 嚣 中， 同样 也 可 以 得 看 合 
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约 代码。 

依然 以 “etherscan.io” 为 例 ， 首 先 假定 已 得 知 对 应 智能 合约 的 以 太 坊 地 址 ， 进 行 搜索 ， 假 设 
“CDCC” 代 币 的 地 址 是 : 

0x78021abd9b06f0456cb9db95a846c302c34£8b8d 


如 图 2-68 所 示 是 查询 的 主页 面 。 单 击 “code” 按 钮 就 能 看 到 当前 合约 的 所 有 代码 ， 如 2-69 
Bra. 


iB Contract 0x78021ABD9b06f0456cB9DB95a846C302c34f8b8D 


Sponsored YA AMFEIX - Invest In The World's First Crypto Fund - Averaging 20% Per Month, Start Today! 
Contract Overview More Info 
Balance: 0 Ether (2) My Name Tag : Not Available, login to up 


Ether Value: $0 查看 智能 合约 Contract Creator: 0x28de3ba33a... at txn 0 
源码 的 按钮 


Token: 536,096.58 EJ v j| ia Token Tracker: F3 CDCC (CDCC) 


Transactions Erc20 Token Txns Read Contract Write Contract Events Analytics | New | 


© Contract Source Code Verified (Exact Match) 


Contract Name: Token Optimization Enabled: Yes with 200 runs 


2-68 ”查看 合约 的 代码 


Transactions Erc20 Token Txns Read Contract Write Contract Events Analytics | New | Comments 


© Contract Source Code Verified (Exact Match) A 
Contract Name: Token Optimization Enabled: Yes with 200 runs 


Compiler Version v0.4.23*commit.124ca40d Evm Version default 


A Contract Source Code (Solidity) ER 


= rs 
* Source Code first verified at https://etherscan.io on Thursday, June 21, 2018 
(UTC) */ 


5 pragma solidity ^8.4.23; 


contract Owned { 
address public owner; 
constnructonr() public [f 
owner = msg.sender; 


modifier onlyOwner { 
require(msg.sender -- owner); 


function transferOwnership(address newOwner) onlyOwner public ( 
owner - newOwnern; 


2-69 合约 的 代码 内 容 


当 我 们 在 交易 详细 页 和 面 查 看 “Event log”， 获 取 触 发 “Event” 的 函数 名 称 后 ， 束 能 够 到 合约 
代码 页 面 得 看 该 图 数 的 代码 ， 如 图 2-70 Pro. 
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e BEtherscan All Filters v Search by Addre: 


Eth: $266.82 (+15.45% Home Blockchain ~ Tokens v Resources v 


Transaction Details 在 交易 详情 页 面 点 击 Event Logs 按钮 


Sponsored: JYJ AMFEIX - Invest Ighe world's First Crypto Fund - Averaging 20% Per Month, Start Today! 


Overview Fvent Logs (1) State Changes New | Comments 


Transaction Hash: 0x6ec564751e3a8e81540a880ab641dba68fc631aa1bdd67c531d14ec373e4415 
Status: 
Block 7761331 8496 Block Confirmations 


Timestamp: © 1 day 7 hrs ago (May-14-2019 11:03:31 PM +UTC) 


From: 0x081cdf822228e9cc77543b2645288e300c013739 [Q 


e Etherscan All Filters > Search by Addre 


Eth: $266.82 (+15.45% Home Blockchain ~ Tokens v Resources v 


Transaction Details 在 交易 详情 页 面 点 击 Event Logs 按钮 


Sponsored: VA AMFEIX - Invest Ig! he World's First Crypto Fund - Averaging 20% Per Month, Start Today! 


Overview Fvent Logs (1) State Changes | New Comments 


Transaction Hash: 0x6ec564751e3a8e81540a880ab641dba68fc631aa1bdd67c531d14ec373e4415 


Status: 
Block [761331 8496 Block Confirmations 


Timestamp: © 1 day 7 hrs ago (May-14-2019 11:03:31 PM +UTC) 


From: 0x081cdf822228e9cc77543b2645288e300c013739 [Q 


Overview Event Logs (1) State Changes | New | Comments 


Transaction Receipt Event Logs 这 个 Transfer 就 是 这 笔 交 易 最 终 在 合约 中 调用 的 函数 名 字 


Address 0x78021abd9 456cb9db95a846c302c34f8b8d0 Q v 


Name [reenster|cindex topic 1 address from, index topic 2 


Topics 0 Oxddf252ad1be2c89b69c2b068fc378daa2952ba37f163c4a211628f55a4df523b3ef 
Hex ~ 一 0x000000000000000000000000081cdf822228e9cc77543b2545288e300c013739 


Hex Y 一 0x0000900000€00000900000000€007b5a45536183f365aeec8ecd39a0f92cc6c12163 


Data Hex v  —* 00000000€000000000000€0000000000000€0000000€00€cb49b44ba6020800000 


2-70 ”查看 某 笔 交易 的 事件 日 志 (Event Log) 
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2.13 ”以 太 坊 零 地 址 


在 以 太 坊 区 块 链 中 存在 一 个 零 地 址 ， 即 它 的 十 六 进 制 值 为 零 ， 原 形 是 : 

0x0000000000000000000000000000000000000000 

这 个 地 址 拥有 下 面 的 特点 : 

e 与 创 世 区 块 无 关 。 

e 当局 动 以 太 坊 挖 矿 程 序 ， 也 即 在 节点 代码 中 局 动 “矿工 ” 挖 矿 时 ， 如 果 没 有 设置 控 矿 的 收益 
地 址 ， 就 会 默认 使 用 零 地 址 挖 矿 ， 挖 矿 所 得 的 ETH 将 归 堆 地址 所 有 。 

e 是 一 个 合法 的 以 太 坊 地 址 ， 能 够 接收 代 币 的 转账 。 

e 它 的 私 钥 可 能 仍然 没 被 碰撞 出 。 


在 区 块 链 浏览 器 中 查询 这 个 地 址 ， 观 察 它 的 以 太 坊 ETH 交易 记录 ， 可 以 发 现 ， 其 所 有 的 ETH 
交易 记录 都 只 有 转 入 而 没有 转 出 的 记录 。 据 此 可 以 猜测 , 它 的 私 钥 还 没有 被 碰撞 出 ， 为 什么 这 样 说 
呢 ? 

因为 每 个 合法 的 以 太 坊 地 址 都 对 应 有 一 个 私 铀 ， 只 要 满足 地 址 格式 ， 我 们 不 需要 知道 它 的 私 
钥 是 什么 就 可 以 使 用 ， 可 以 癌 它 交易 转账 、 查 询 它 的 各 种 操作 记录 等 。 

零 地 址 便 是 如 此 ， 因 为 它 很 容易 被 记 住 及 写 出 ， 全 部 数值 为 0 即 可 ， 不 需要 刻意 地 去 进行 运 
算得 出 ,但 它 亦 始终 对 应 有 一 个 私 钥 。 在 私 钥 生 成 公 钥 的 算法 中 ,我 们 知道 如 果 要 根据 一 个 公 钥 来 
逆 推出 私 铀 ， 概 率 非 常 小 ， 但 不 是 不 可 能 ， 只 要 概率 不 为 0， 就 不 能 说 不 可 能 。 

加 上 它 所 有 的 ETH 交易 记录 都 是 只 有 被 转 入 而 没有 转 出 的 记录 ， 最 难以 想象 的 情况 就 是 零 地 
址 的 私 钥 已 经 被 碰撞 出 了 ， 但 是 拥有 者 还 不 打算 转 出 任何 一 个 ETH. 

综 上 所 述 ， 零 地 址 的 私 钥 可 能 还 没 被 碰撞 出 。 


2.13.1 零 地 址 的 交 匈 转 出 假象 


上 面 一 小 节 讲 到 ， 在 零 地 址 的 私 钥 还 没 被 碰撞 出 的 时 候 是 不 可 能 有 人 使 用 者 地 址 去 做 交易 转 
出 操作 的 。 但 是 , 当 我 们 在 区 块 链 浏览 占 中 查看 零 地 址 的 非 ETH 交易 记录 时 却 能 够 看 到 存在 “Out” 
( 转 出 〉 的 情况 ， 如 图 2-71 所 示 。 
这 种 情况 怎么 解释 呢 ? 这 是 云 地 址 区 易 转 出 的 假象 。 回 顾 " 浏览 需 的 交易 记录 不 能 作为 非 ETH 
的 交易 依据 ”一 节 中 所 讲 到 的 内 容 就 能 明白。 
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BB Addres4 0x0000000000000000000000000000000000000000 e: CIypio LOan v 
Feature Tip: Enable advanced mode, change languages and more. Customize now! 
Overview More Info 


Balance 7,665.104655332599681128 Ethor © My Name Tag : Not Available, login to update 


Ether Value $2,043,056.99 (& S266 54/ETH| Mined: 95 Blocks and 2 Uncles 


$15,159,731.907,127 9... v 


Transactions Internal Txns Erc20 Token Txns Erc721 Token Txns Mined Blocks Mined Uncles Analytics | New. 


Comments m 
| 零 地 址 中 ， 转 出 ERC20 Token 的 交易 


lz Latest 25 ERC-20 Token Transfer Events [Show More] 


Txn Hash Age From 


Oxef80c768e31 1 min ago 0x0000000000 OUT 0x03cb0021808 


0x440b396360 1 min ago 0x0000000000 0x03cb0021808 


2-1 零 地 址 的 非 ETH 交易 记录 存在 “Out ”的 情况 


其 原因 是 , 零 地 址 在 智能 合约 的 触发 “Transfer event” 事 件 的 代码 中 被 开发 者 设置 为 了 “Event” 
的 “from” 参 数 。 例 如 ， 下 面 的 代码 中 ，“address(0)” 就 被 当 作 了 “Transfer event” 的 “from” 参 
数 ， 当 函数 “mint” 被 “sendRawTransaction” 调 用 后 ， 所 触发 的 “Event” 就 会 被 记录 到 区 块 中 ， 
最 终 被 区 块 链 浏览 器 获取 到 而 显示 在 交易 记录 列表 页 面 中 ， 页 面 所 显示 的 “from” 就 是 “mint” 隔 
数 中 “Transfer” 事 件 的 入 参 “from” 值 。 


function mint (address to, uint256 amount) onlyOwner canMint public returns 
(bool) { 
totalSupply = totalSupply .add( amount); 
balances[ to] - balances[ to].add( amount); 
Mint( to, amount); 
Transfer(address(0), to, amount); // 这 一 行 触发 事件 
return true; 


} 

上 和 耐 的 合约 函数 达到 了 一 个 给 指定 的 以 太 坊 地 址 添加 资产 的 目的 , “to” 是 接收 者 ,“_amount” 
是 数量 。 

在 上 面 的 流程 中 需要 注意 的 是 ， 负 责 使 用 私 钥 签名 以 太 坊 “sendRawTransaction” 接 口 函 数 的 
不 是 零 地 址 的 , 而 是 谁 调用 这 个 接口 函数 谁 束 签名 。 这 说 明 在 区 块 链 浏览 器 的 交易 详情 页 面 中 显示 
的 “fom” 数 据 项 和 进行 签名 的 地 址 是 没有 关系 的 ， 仅 和 “Transfer Event ”的 “from” 入 参 值 有 关 ， 
即 “Transfer Event” 的 from 才 是 区 块 链 浏览 器 交易 详情 页 面 中 显示 的 “from”。 

那么 零 地 址 是 否 可 以 转 出 资产 呢 ? 答案 是 可 以 的 。 对 于 签名 不 使 用 零 地 址 的 交易 ， 只 要 满足 
从 零 地 址 的 余额 中 减少 资产 , 然后 将 减少 的 资产 累加 到 收 计 地 址 即 可 。 例如 下 面 的 函数 ， 只 要 它 被 
“sendRawTransaction ”指定 调用 后 就 能 够 实现 从 零 地 址 转 出 资产 ， 前 提 是 我 们 得 在 其 他 地 方 先 给 
零 地 址 赋予 资产 。 


econstrucbor() public [ 
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balances[0x0] = 1000000000; // 给 零 地 址 赋予 代 币 资产 
} 
function release (address to,uint256 value)public returns (bool success)! 
require(balances[0x0] >= value); 
balances[0x0] -- value; 
balances[ to] += value; 
emit Transfer(0x0, to, value); 
return true; 


2.13.2 FHEA 


以 下 是 零 地 址 使 用 最 多 的 两 种 场景 : 


COD 用 于 启动 以 太 坊 挖 矿 程序 ， 如 果 没 有 设置 挖 矿 的 收益 地 址 就 默认 使 用 零 地 址 挖 矿 。 
(2) 在 智能 合约 的 代码 编写 中 使 用 零 地 址 ， 例 如 作为 函数 的 参数 。 


在 第 一 种 场景 中 ， 零 地 址 充当 的 是 一 个 默认 统一 处 理 的 方式 。 比 如 ， 挖 矿 过 程 中 没有 设置 收 
蔓 地 址 ,这 个 时 候 应 该 怎么 办 呢 ? 一 种 做 法 是 强制 不 允许 用 户 进行 挖 矿 操 作 , 要 求 必须 设置 收益 地 
址 。 另 一 种 做 法 是 不 强制 ， 可 以 继续 挖 矿 。 此 时 就 需要 一 个 默认 的 收益 地 址 ,那么 这 个 地 址 设置 为 
谁 合适 ? 坚 无 疑问 ,选择 零 地 址 是 最 为 合理 的 ， 就 表现 形式 上 来 看 ， 和 去 代表 的 就 是 开始 ， 也 很 容易 
被 记 住 。 

在 第 二 种 场景 中 ， 如 果 我 们 要 给 茶 个 地 址 直接 赠送 “ 代 币 ”资产 或 者 是 表现 为 生成 “ 代 币 ” 
资产 ， 在 操作 完 之 后 ， 必 须 触 发 转账 事件 “Transfer event”， 这 就 需要 一 个 “from” 参 数 来 表示 从 
哪儿 转账 出 去 的 。 但 是 , 基于 从 无 到 有 再 转移 的 过 程 ， 并 不 存在 从 茶 个 确切 的 拥有 资产 的 地 址 转账 
到 男 一 个 地 址 的 过 程 ， 这 个 “from” 选 择 为 零 地 址 最 为 合理 。 

回顾 前 面 合约 函数 的 例子 : 

function mint (address to, uint256 amount) onlyOwner canMint public returns 
(bool) ( 

totalSupply = totalSupply .add( amount); 
balances[ to] = balances[ to].add( amount); 
Mint( to, amount); 

Transfer(address(0), to, amount); 


return true; 


} 

该 例 就 实现 了 往 一 个 给 指定 的 以 太 坊 地 址 添加 资产 的 目的 ， 添 加 的 形式 是 直接 添加 ， 不 存在 
从 一 个 地 址 转账 给 收 革 地 址 。 这 个 时 候 触 发 转账 事件 “Transfer event”，“from” 参 数 选择 的 就 是 
零 地 址 。 

因此 ， 我 们 可 以 将 零 地 址 看 作 是 某 些 情况 下 的 合理 默认 值 ， 就 好 比 我 们 在 编程 时 ， 初 始 化 一 
个 “int” 类 型 的 变量 ， 其 默认 值 总 是 0 一 样 。 
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2.14 小 结 


第 2 章 可 以 说 是 全 书 最 为 重要 的 一 草 ， 守 括 了 以 太 坊 基础 性 的 知识 点 ， 整 体 介绍 了 以 太 坊 的 
技术 模块 , 详细 地 讲解 了 区 块 的 组 成 及 其 内 部 各 个 字段 变量 的 作用 , 对 以 后 实现 以 太 坊 相关 接口 起 
到 先行 作用 。 

同时 也 从 比特 币 的 UTXO 模型 引申 出 以 太 坊 的 账户 模型 , 介绍 了 以 太 坊 的 MPT 树 与 默 元 尔 树 
和 字典 树 的 特性 ， 以 及 MPT 在 账户 体系 中 的 应 用 。 

特别 地 ， 本 和 曹 还 讲解 了 以 太 坊 的 “Ghost 协议 ”， 以 及 以 太 坊 公 链 在 分 又 网 络 中 ， 根 据 “Ghost 
协议 ”选择 最 优 链 ， 而 非 比 特 币 的 最 长 链 规 则 。 由 该 协议 所 衍生 的 叔 块 知识 也 有 对 应 的 讲解 ， 包 含 
叔 块 的 定义 、 打 包 规 则 和 奖励 规则 。 

本 草 也 先行 简介 了 以 太 坊 代表 性 的 智能 合约 模块 ， 并 列举 了 两 个 经 典 的 合约 标准 一 一 ERC20 
与 ERC721。 在 第 3 革 我 们 将 会 进一步 对 合约 模块 进行 学 习 。 

在 以 太 坊 交易 模块 一 节 中 ，“ 交 易 参 数 的 说 明 ” 与 “交易 方法 的 真实 含义 ”这 两 节 内 容 尤 其 
重要 ， 通 过 这 两 节 的 学 习 ， 我 们 可 以 深刻 地 理解 以 太 坊 交易 的 两 个 核心 接口 “sendTransaction” 和 
“sendRawTransaction ”的 区 别 及 其 交易 的 实际 含义 ， 交 易 并 不 一 定 就 是 代 币 的 转账 ， 它 还 能 做 其 
他 事情 。 

男 外 ， 关 于 以 太 坊 浏览 器 的 基本 使 用 ， 也 在 本 章 做 了 相应 的 介绍 。 

最 后 ， 还 介绍 了 “ 非 ETH 交易 记录 不 能 作为 资产 转账 成 功 的 依据 ”和 “和 零 地 址 的 交易 转 出 假 
象 ”两 个 较 冷 门 的 知识 点 ， 以 扩大 读者 的 知识 面 。 


CLEASAN E S. Abs Rd 


8 B cr 2 BS Rs T DUDCUL NK B3 Hot , 其 他 的 公 链 也 同样 具备 智能 合约 机 制 , 例如 EOS A SESS, 
它 是 区 块 链 技术 的 一 个 模块 。 
在 第 2 章 中 ， 我 们 介绍 了 智能 合约 的 部 分 知识 点 ， 本 重 我 们 将 从 一 个 整体 的 角度 来 进一步 认 


识 智 能 合约 。 
3.1 智能 合约 与 以 太 坊 DApp 


以 太 坊 的 智能 合约 功能 模块 可 以 让 开发 者 目 由 地 使 用 特定 的 计算 机 语言 来 编写 智能 合约 ， 并 
以 代码 文件 的 形式 呈现 ,如 果 在 以 太 坊 网 络 上 发 布 这 份 智能 合约 ,此 时 的 智能 合约 便 变 成 了 一 个 智 
能 合约 程序 。 

这 个 程序 运行 在 以 太 坊 上 ， 拥 有 目 己 独特 的 功能 ， 这 些 功能 也 能 让 别人 使 用 。 例 如 ， 以 太 猫 
话 戏 、 以 太 僵尸 游戏 等 , 它们 的 原形 都 是 发 布 在 以 太 坊 上 的 一 份 乔 能 合约 , 这 份 智能 合约 发 布 之 后 ， 
就 会 被 广播 到 整个 节点 网 络 的 节点 中 ， 形 成 分 布 式 应 用 。 

这 些 基于 智能 合约 的 以 太 坊 应 用 ， 还 有 为 外 一 个 名 称 ， 就 是 “以 太 坊 智能 合约 DApp”， 全 称 
是 “以 太 坊 智能 合约 分 布 式 应 用 ”。 

以 太 坊 的 DApp 有 很 多 种 撩 型 ， 有 基于 重 能 合约 实现 的 应 用 ， 也 有 基于 以 太 坊 功能 接口 实现 
的 应 用 ， 比 如 钱包 类 等 ， 统 称 为 以 太 坊 DApp。 

所 以 ， 智 能 合约 仅 是 以 太 坊 DApp 实现 的 方式 之 一 。 以 太 坊 DApp 的 组 成 如 图 3-1 所 示 。 
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的 | 


| sucesos | 
oapp | 


| amsmneam | 


3-1 以 太 坊 DApp 的 分 类 
3.2 认识 Remix 


智能 合约 的 编写 需要 使 用 计算 机 语言 ， 目 前 第 用 的 是 Solidity 语言 。Solidity 也 是 Ethereum 官方 设 
计 和 文 持 的 编程 语言 ， 专 门 用 于 编写 智能 合约 。 关 于 Solidity 编程 语言 的 知识 ， 读 者 可 以 参看 相关 资料 。 
本 节 我 们 主要 从 智能 合约 编写 工具 Remix 的 基础 使 用 以 及 智能 合约 的 编写 方法 这 两 方面 进行 讲解 。 
编写 智能 合约 的 工具 有 很 多 种 ， 笔 者 推荐 使 用 —— Remix. 

Remix 是 一 个 开源 的 Solidity 智能 合约 开发 环境 ， 它 提供 了 基本 的 编 详 、 部 署 至 本 地 、 合 约 测 
试 和 执行 合约 等 功能 ， 它 的 开源 地 址 是 https://github.com/ethereum/remix。 我 们 可 以 从 这 个 地 址 中 
把 Remix 的 源码 下 载 下 来 ， 然 后 日 行 在 本 地 编译 运行 ， 但 是 这 个 过 程 可 能 会 遇 到 很 多 编译 上 的 问 
题 ， 例 如 环境 配置 问题 等 。 建 议 大 家 使 用 Remix 的 网 上 浏览 占 版 本 ， 这 样 就 不 用 目 己 下 载 源 人 码 到 
本 地 再 进行 编译 了 , 可 以 直接 通过 浏览 右 打 开 链 接 进 行 乔 能 合约 的 编写 ， Remix 网 上 浏览 右 的 链接 
为 https://remix.ethereum.org/。 

在 浏览 器 中 打开 上 面 的 链接 ， 就 会 看 到 如 图 3-2 所 示 的 界面 ， 这 就 是 Remix 的 主页 。 


> Compie Run Analysis Testing Debugeer Setángs Supp 


Currert 
version-0.4.25*commt.59tf8r1 Emscnpten.dang 


Select new compter version 


* Mto compie Enábie Opbimizanon 
Hede wamnings 


© Sart I compile 


fonction Balle ti uin 一 vur " 二 Swarm 


rperson) pA 1; 
pr ce ei _nunpreposals; Detais iS ABI WD Bytecode 
) 


May only be called by E thairpers on) ME Static Analysis raised 2 waming(s) that requires your ateation X 
function givetightTovote v ick. here to show the arning(s). 

1f (nsg.sende cha án ve- son eU. [t9 Not Ss» ed) return; 

voters| toWoten].weight 


) brosser/ballot.sol:]9:5: Warning: Defining coastructors aX 
` function Ballot (ulints mumProposals) public | 
¥ o L [2] only remix transactions, script + QD Search tansactions " (Relevent sourco part starts horo asd spons across i 


remix. debuglio!p) : Display help mezaage for debugging 


Welcome to Remix v9.7.3 
You can use this termim] for: 


* Checking transactions details end start debugging. 
* Running JaraScript ser iota . The folloving libraries are accessible: 


LJ 
^-^ At 
SS 
* Executing 5oa command to interact vith the Beair interface (see list of commands above). Kote that these commands ean also be 


图 3-2 Remix 的 主页 ， 就 是 它 的 主 界面 
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在 主页 面 左 上 角 的 图 标 中 ， 我 们 要 知道 其 中 3 个 选项 所 代表 的 含义 : “十 ”图 标 代表 创建 一 
个 新 文件 ， 形 如 文件 夹 的 按钮 表示 从 电脑 打开 一 个 文件 ，“browser” 是 默认 的 存放 所 有 新 建文 件 
的 文件 夹 ， 如 图 3-3 所 示 。 


o zz 00 929 % * browser/ballot.sol * 


-— Aa x , 
— 从 电脑 打开 一 个 文件 
* browser pragma solidity ^0.4.0; 


新 建 一 个 文件 2* contract Ballot { 


» config struct Voter { 
uint weight; 
bool voted; 
uint8 vote; 
address delegate; 
} 
struct Proposal { 
uint voteCount; 
) 


address chairperson; 
mapping(address -» Voter) voters; 
Proposal[] proposals; 


这 件 的 存放 地 方 


/// Create a new ballot with $( numP 

function Ballot(uint8  numProposals 
chairperson = msg.sender; 
voters[chairperson].weight - 1; 


3-3 Remix 左上 角 的 按钮 工具 栏 


图 3-3 中 间 是 Solidity 代码 编写 区 域 ， 每 一 个 Solidity 代码 文件 的 后 级 是 .sol，Remix 的 功能 非 
第 丰富 ， 在 我 们 编写 代码 时 ， 它 会 目 动 支持 下 面 两 个 功能 : 
CD 语法 关键 字 的 目 动 提 示 功 能 (智能 关键 字 提 示 功 能 ) ， 能 够 根据 和 输入 的 首 字 母 进行 提示 。 
(2) 具备 目 动 编译 功能 ， 当 在 代码 编写 区 域 进 行 了 修改 时 ，Remix 默认 会 目 动 地 对 当前 代码 
的 .sol 文件 进行 编译 ， 如 果 存 在 语法 错误 ， 会 直接 显示 出 来 。 
如 图 3-4 所 示 ， 在 test.sol 文件 中 输入 首 字 母 c 后 ，Remix 于 是 显示 出 了 字母 c 开头 的 关键 字 
提示 ， 这 些 都 是 Solidity 语法 所 文 持 的 ， 此 外 由 于 “Auto compile” 选 项 被 勾 选 ， 因 此 还 能 自动 进 
行 编 诺 ， 如 果 不 想 目 动 进行 编译 ， 把 “ vV ”去 掉 即 可 。 


browser/test.sol x Run Analysis Testing Debugger Settings Sup 


pragma solidity ^6.4.21; 
Current 

e version:0.4 25*commit.59dbfBf1.Emscripten.clang 

constructor keyword ó 

continue keyword Select new compiler version ' 

constant keyword 

SR * Auto compile Enable Optimization 

contract k 

case keyword 

catch k 

copyof | 


Hide warnings 


Z2 Start to compile 


v 4 Swarm 


Details E ^B! E Bytecode 


browser/test. sol:3:1: ParserError: Expected pragma, impoX* 


c 


3-4 Remix 的 智能 关键 字 提 示 功 能 
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在 编 详 的 时 候 ， 还 可 以 选择 纺 诺 顺 的 版 本 。 注 意 ， 不 同 的 编 详 项 版 本 编 详 出 的 Bytecode Cr 
13) 是 不 一 样 的 ， 所 文 持 的 Solidity 语法 也 不 同 。 一 般 来 说 ， 选 择 带 有 “commit” 单 词 且 不 含有 
“nightly” 单 词 的 编译 占 版 本 ， 这 类 版 本 的 编 详 右 不 容易 出 问题 。 图 3-5 是 一 个 选择 编 详 器 版 本 的 
例子 。 


Run Analysis Testing Debugger Settings Sup 


Current version:0.5.0- 
nightly.2018.10.6*commit. 3635527b.Emscripten.clang 


Select new compiler version 

WV LES nry.v TO "CUI. 1 USPTO UU 
0.4.24-nighty.2018.4.26*commit.ef2111a2 
0.4.24-nightly.2018.4.25*commit.81cca26f 
0.4.24-nightly.2018.4.24*commit.258ae892 
0.4.24-nightly.2018.4.23tcommit c7ee2ca0 
0.4.24-nightly.2018.4.22*commit 2fae248d 
0.4 24-nightly.2018.4 20*tcommit 328431 
0.4.24-nightly.2018.4.19*commit 274799068 
0.4.23*commit. 124ca40d 
0.4.23-nightly.2018.4.19*commit.ae834e3d 
0.4.23-nightly.2018.4.18* commit.85687a37 
0.4.23-nightl y.2018.4.17 *commit.5499db01 
0.4.22*commit.4cb486ee 
0.4.22-nightly.2018.4.16*commit.d8030c9b 
0.4.22-nightly.2018.4.14*commit. /3ca3e8a 
0.4.22-nightiy.2018.4.13* commit. 2001cc6b 
0.4.22-nightiv.2018.4.12*commit.c3dc67d0 


3-5 在 Remix 中 选择 合适 的 Solidity 编译 器 版 本 
从 图 3-5 可 以 看 出 ，Solidity 编译 器 版 本 的 名 称 比 较 复 杂 ， 这 些 名 称 符 合 下 面 的 3 个 规则 : 


CD 版 本 号 。 
(2) 前 级 标记 ， 通 常 是 develop.YYYY.MM.DD 或 者 nightly. Y YYY.MM.DD 。 
(3) 通过 commit.GitHash 提交 。 


例如 ，0.4.25+commit.59dbf8f1.Emscripten.clang，0.4.25 就 是 版 本 号 ， 它 的 git 提交 的 哈 希 值 是 
59dbf8f1， 这 是 Emscripten.clang 默认 加 上 的 。 

此 外 ， 如 果 存 在 一 些 本 地 修改 ， 提 交 时 会 目 动 加 上 .mod 后 级 。 

了 解 了 Remix 基础 知识 后 ， 我 们 就 能 进行 智能 合约 的 编写 了 了。 


3.3 ”实现 加 法 程序 


下 面 使 用 Solidity 编写 一 个 实现 加 法 计算 的 智能 合约 。 没 错 ! 就 简单 地 实现 这 么 一 个 功能 ， 它 
也 是 一 份 智能 合约 ， 一 定 要 清楚 并 不 是 编写 和 代 币 相关 的 程序 才 叫 智能 合约 。 

单 击 Remix 编译 器 左上 角 的 “+” 按 钮 ， 创 建 一 个 新 的 .sol 文件 ， 名 称 为 “test.sol”， 如 图 3-6 
所 示 。 


File Name 


test.sol 


3-6 ”创建 新 文件 
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然后 输入 下 面 的 代码 : 


pragma solidity ^0.4.23; // 指 定 版 本 
contract Test { 
// ”输入 两 个 参数 
function add(uint8 argl,uint8 arg2) public pure returns (uint8) { 
return argltarg2; 
} 
} 


如 图 3-7 所 示 为 编译 器 中 的 代码 示例 。 


« 


: browser/test.sol " 


pragma solidity ^0.4.23; //lE;rx4 


~ contract Test | 


function add(uint8 argi,uint8 anrg2) public pure returns (uint8) { 
return argil-arg2; 


图 3-7 ”编译 器 中 的 代码 示例 
日 动 编 详 后 的 结果 区 域 显 示 为 绿色 ， 证 明代 码 在 编译 层面 是 没有 问题 的 ， 如 图 3-8 所 示 。 


Current 
version:0.4.23*commit.124ca40d.Emscripten.clang 


Select new compiler version v 
选择 和 我 们 代码 中 避 Auto compile *! Enable Optimization 


j N IH [ JE? eH a Hide warnings 


© Start to compile 


v 4 Swarm 


Details F ABI  K5Bytecode 


38  H3liE REIS AR 


以 上 就 是 一 个 简单 的 加 法 运算 的 智能 合约 的 实现 ， 我 们 稍 后 在 下 面 的 一 节 中 对 这 份 智能 合约 
进行 发 布 并 调用 。 
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34 实现 ERC20 代 币 智能 合约 


以 太 坊 上 发 行 的 “ 代 币 ” 百 分 之 九 十 以 上 都 是 基于 “ERC20” 标 准 的 代 币 合约 , 可 以 说 “ERC20” 
标准 的 代 币 合约 目前 是 最 为 流行 的 合约 标准 。 

本 节 我 们 来 学 习 实 现 一 个 符合 “ERC20” 标 准 的 代 币 智能 合约 ， 模 仿 上 一 节 的 步 又， 在 Remix 
编译 器 中 新 建 一 个 名 称 为 “MyToken.sol” 的 文件 。 


3.4.1 定义 标准 变量 


首先 在 代码 中 定义 标准 要 求 的 变量 ， 如 下 所 示 : 

pragma solidity ^0.4.23; // 指 定 版 本 

contract MyToken { 
string public name = "My first token coin"; // 代 币 的 名 称 
uint8 public decimals = 18; // 代 币 单位 精确 到 小 数 点 后 的 位 数 
string public symbol = "MFTC"; // 代 币 的 符号 
uint public totalSupply = 100;  // 代 币 的 发 行 量 

} 


如 图 3-9 所 示 为 编译 器 的 代码 示例 。 


« 


= browser/MyToken.sol - 


pragma solidity ^0.4.23; //!Hir hu 


+ contract MyToken ( 
string public name - "My first token coin"; // 代 币 的 名 称 
uint8 public decimals = 18;  // 代 币 单位 精确 到 小 数 点 后 的 位 数 
string public symbol = "MFTC"; // 代 币 的 符号 


uint public totalsupply = 100; // 代 币 的 发 行 量 


3-9 ”编译 器 中 的 代码 示例 


这 里 我 们 定义 了 name、decimals、symbol、totalSupply Jt 4 个 变量 ， 注 意 ，“totalSupply” 变 
量 表示 发 行 量 ， 如 果 这 个 发 行 量 是 一 个 很 大 的 数 ， 例 如 几 百 亿 ， 那 么 最 好 将 其 变量 类 型 设 为 256 
位 的 无 符号 整数 类 型 ， 即 “uint256”， 以 避免 超过 最 大 整数 范围 的 上 限 。 


3.4.2 ”事件 与 构造 函数 


在 基础 的 变量 定义 好 之 后 ， 我 们 定义 合约 中 的 “Event” 事 件 ， 再 补充 一 个 构造 函数 ， 在 构造 
国 数 中 可 以 进行 一 些 变量 的 初始 化 ， 例 如 把 发 行 量 “totalSupply” 的 初始 化 放 入 构造 图 数 中 ， 如 网 
3-10 所 示 。 
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pragma solidity ^0.4.23; // 指 定 版 本 


r contract MyToken { 


string public name = "My first token coin”; 


uint8 public decimals = 18; A RTE Xr Bux 


string public symbol = "MFTC"; // 人 由 日 
uint public totalsupply; // (ít! 


/ / : É Event 和 授权 Event 
event Transfer(address indexed from, address indexed _to, uint256 value); 
event Approval(address indexed owner, address indexed  spender, uint256 value); 


/ const tor 是 Solidity | 


/ / Puc ) 
constructor() public { 
totalSupply = 1688; / 


图 3-10 将 totalSupply 的 初始 化 放 入 构造 函数 


3.4.3 Solidity 的 常见 关键 字 


在 上 一 节 的 构造 函数 代码 中 ， 可 以 看 到 “constructor” 后 面 有 一 个 “public”， 这 个 public 是 
Solidity 语言 的 一 个 关键 字 。 除 了 这 个 关键 字 之 外 ，Solidity 语言 还 有 下 面 6 个 关键 字 ， 了 解 这些 关 
键 字 的 含义 对 于 我 们 理解 和 编写 智能 合约 很 有 必要 。 


public， 可 以 修饰 变量 和 吨 数 ， 被 修饰 的 函数 或 变量 可 以 被 任何 合约 调用 (或 访问 ) 。 默 认 的 
变量 和 函数 使 用 该 属性 。 

private， 可 以 修饰 变量 和 函数 ， 被 修饰 者 只 能 被 当前 合约 内 部 的 代码 所 调用 (或 访问 ) ,不 
能 被 外 部 合约 调用 或 继承 它 的 子 合约 调用 (或 访问 ) 。 

external， 只 能 修饰 函数 ， 被 修饰 的 函数 只 能 被 当前 合约 之 外 的 合约 所 调用 (或 访问 ) ,不 能 
被 自己 和 继承 它 的 合约 调用 (或 访问 ) 。 

internal， 可 以 修饰 变量 和 函数 ， 被 修饰 者 可 以 被 当前 合约 内 部 以 及 继承 它 的 合约 调用 (或 访 
问 ) ， 但 不 能 被 外 部 合约 调用 (或 访问 ) 。 

Vview， 只 能 修饰 函数 ， 函 数 内 部 能 够 对 外 部 变量 进行 读 取 操作 ， 但 是 不 能 进行 修改 . 
pure， 只 能 修饰 函数 ， 函 数 内 部 不 能 对 外 部 的 变量 进行 读 取 和 修改 操作 ， 它 只 能 对 传 参 进 入 
的 参数 量 进行 读 写 操作 。 


下 面 我 们 根据 源码 示例 来 进一步 理解 这 些 关 键 在 ， 请 注意 代码 中 的 注释 。 
pragma solidity ^0.4.23; // 指 定 版 本 


contract MyToken( // 外 部 合约 


} 


function getHalfTotalSupply() external view returns (uint half); 
function internalFunc() internal view returns (uint half); 


contract parent { 


uint64 age - 50; 

// addr 是 MyToken 合约 部 署 在 链 上 后 的 地 址 

address public addr = 0x72bA7d8E73Fe8bEb666Ea66babC8116a41bFb10e2; 
function func() public view { 


MyToken m = MyToken(addr); // 实例 化 外 部 合约 
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m.getHalfTotalSupply(); // external 允许 parent 调用 外 部 合约 MyToken 的 函数 
m.internalFunc(); // 报错 ， 因 为 这 个 是 internal 的 函数 (或 方法 ) , 
// 只 能 在 MyToken 内 部 或 继承 了 它 的 合约 中 使 用 
} 
function publicFunc() public í( 
age - age * 6; 
} 
function privateFunc() private returns (uint64 ret) { 
uint64 t - internalFunc(); 
age = t / 2; 
return age; 


} 


function internalFunc() internal returns (uint64 ret) { 
age - age * 2; 
return ret; 


j 
function viewFunc(uint64 argl) public view returns (uint64 ret) { 


argl = argl + age + 9; // 可 以 访问 age 
// age 初始 值 是 50 
age -» age F 7; // 尝试 修改 ， 编 译 会 发 出 警告 ， 但 是 编译 可 以 通过 
uint64 d = age + argl; // 变量 age 的 值 不 会 改变 ， 依 然 是 50 
uint64 c = d/2; 
return c; 
} 
function pureFunc(uint64 argl) public pure returns (uint64 ret) { 
argl = argl + 9; 
uint64 d = age + argl; // 编译 报错 ! pure 完全 禁止 外 部 age 变量 的 读 写 
//uint64 c = d/2; 
return argl; 


} 


contract child is parent { 
function usePrivateFunc() public returns (uint64 ret) { 
uint64 v = privateFunc(); // 报错 ， 尝 试 调用 parent 合约 中 的 private 函数 
return v; 


} 
function useInternalFunc() public returns (uint64 ret) { 


uint64 v = internalFunc(); // 可 以 使 用 ， 因 为 child 继承 目 Parent 
return v; 


3.4.4 授权 与 余额 


接 春 我 们 继续 补充 标准 中 的 代 币 余额 和 授权 额度 。 首 先 ， 代 币 余 额 和 授权 额度 存储 的 数据 续 
构 是 一 个 “Map”，“Key” 对 应 的 是 以 太 坊 的 地 址 ， 然 后 “Value” 对 应 的 是 数值 ， 该 数值 根据 用 
户 的 以 太 坊 地 址 来 映射 用 户 所 拥有 的 余额 或 额度 的 多 少 ， 碍 询 的 时 间 复 杂 度 是 0(1)， 这 样 的 查询 
效率 是 很 高 的 。 相 对 应 地 ， 也 要 实现 标准 中 的 “balanceOf” 代 币 余 额 得 询 、“approve” 授 权 和 额度 
申请 和 “allowance” 授 权 和 额度 查询 这 3 个 图 数 ， 如 图 3-11 所 示 。 
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mapping (address => uint256) public balances; // 
mapping (address => mapping (address => uint256)) Public po // FAM 


/} constructor Æ Solidity "Jii A NJF 
constructor() public ( 
totalSupply = 108; // ETERU 
balances[msg. sender] = totalSupply; 


) 


Si RI E d CÁC If o 

function balanceOf(address owner) public view returns (uint256 balance) ( 
return balances[ owner]; 

) 


function approve(address  spender, uint256 value) public returns (bool success) ( 
allowed[msg.sender][ spender] = "value; 
emit Approval(msg.sender,  spender, value); 
return true; 


^ di owner 1 spender "rij owner 给  spender 授权 ; 
function allowance(address owner, address spe di, a Ae view returns (uint256 remaining) { 
return allowed[ owner][. spender]; 


3-11 ERC20 标准 的 部 分 函数 


在 “approve” 函 数 中 ， 内 部 代码 倒数 第 二 行 “emit” 触 发 的 就 是 授权 事件 “approve event”。 
定义 好 余额 相关 的 操作 后 ， 如 果 我 们 想 在 合约 创建 的 时 候 就 对 某 一 个 账号 进行 代 币 数值 的 赋 
值 ， 可 以 在 构造 图 数 “constructor” 中 进行 ， 这 也 是 一 般 的 合约 发 布 把 代 币 转 出 到 一 个 对 公 的 以 太 
坊 地 址 的 做 法 , 之 所 以 这 样 做 是 因为 智能 合约 拥有 一 个 和 钱包 地 址 格式 完全 一 样 的 以 太 坊 地 址 , 但 
是 在 合约 创建 的 时 候 ， 我 们 没有 这 个 智能 合约 的 私 钥 ， 也 就 是 说 , 我 们 不 能 直接 像 导 入 钱包 一 样 将 
ee a ERC20 代 币 转账 的 应 用 中 ， 把 代 币 转 出 。 
还 有 一 点 ， 如 果 我 们 要 实现 智能 合约 的 代 币 数值 锁 仓 ， 也 可 以 在 合约 中 通过 目 己 实现 的 函数 
MN. 下 面 修 改 构造 函数 中 的 代码 ， 对 合约 发 布 者 进行 代 币 赋值 ， 如 图 3-12 所 示 。 
// T iura 14 3& EF] Ai 8D] 2: E 16] 
constructor() public 


totalSupply = 100000000000000000000000000; // ”修改 发 行 量 初始 一 亿 
balances[msg.sender] = totalSupply; 


3-12 ”在 构造 函数 初始 化 发 行 量 并 将 所 有 的 代 币 给 予 某 个 地 址 


其 中 的 “msg.sender” 就 是 当前 合约 发 布 者 的 以 太 坊 地 址 ， 我 们 把 “totalSupply” 发 行星 全 部 
给 予 了 这 个 地 址 。 当 然 ， 也 可 以 进行 控制 ， 不 全 部 给 予 ， 只 给 一 小 部 分 ， 这 些 都 是 允许 的 。 


3.4.5 ”转账 函数 


下 面 在 合约 中 完成 标准 中 的 转账 函数 “transfer”， 如 图 3-13 所 示 。 


// 代 币 转账 

function transfer(address to, uint256 value) public returns (bool success) ( 
require( to !- exe); 
require(balances[msg.sender] »- value); 
require(balances[ to] + value »- balances[ to]); 


balances[msg.sender] -- value; 
balances[ to] += value; 
emit Transfer(msg.sender, 
return true; 


to, value); 


3-13 ”完成 转账 函数 “transfer” 
转账 函数 的 内 部 首先 要 进行 一 些 参数 校 验 ， 一 般 使 用 Solidity 语法 中 的 “require” 关 键 字 来 进 
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行 限制 。 例 如 ， 在 上 和 面 的 代码 中 ，“transfer” 中 的 第 一 行 限制 收 蒜 地 址 不 能 是 零 地 址 ， 第 二 行 对 
代 币 的 转 出 方 “msg.sender” 所 持 有 的 余额 数 值 和 想 要 被 转 出 的 数值 “value” 进 行 比 较 判 断 ， 判 断 
余额 是 否 比 “value” 多 ， 因 为 要 转 出 ， 所 以 余额 必须 比 “value” 多 。 

在 参数 判断 通过 后 ， 通 过 减少 转 出 者 的 余额 值 ， 即 “balances[msg.sender]-=value ”， 来 减 去 
“value”， 然 后 增加 收 款 者 的 余额 ， 即 “balances[_to]+=value ”这 么 一 个 过 程 来 实现 数值 层面 的 转 
账 。 这 里 要 注意 ， 到 “balances[ to]+=value” 这 一 行 ， 目 前 的 修改 都 是 基于 内 存 层 面 的 ， 还 没有 与 
到 区 块 链 上 ， 也 就 是 说 这 些 修 改 还 没有 真实 地 在 区 块 链 上 生效 。 

最 后 ， 我 们 要 发 出 一 个 转账 事件 “transfer event”， 然 后 返回 trues RIE] true 的 时 候 ， 如 果 当 
前 调用 的 “transfer” 函 数 由 矿工 提取 “sendRawTransaction” 中 的 data 传 入 EVM， 那 么 转账 的 修 
改 就 会 被 持久 地 记录 下 来 ， 并 真实 生效 。 

还 可 以 使 用 另外 一 个 图 数 “transferFrom” 来 实现 转账 ， 具 体 的 代码 如 图 3-14 所 示 。 


// 代 币 转账 
function transfer(address to, uint256 value) public returns (bool success) ( 
require( to !- 0x0); // 不 允许 收 款 地 址 是 零 地 寺 
require(balances[msg.sender] >= value); 
require(balances[ to] + value > balances[ to]); 
balances[msg.sender] -- value; 
balances[ to] += | value; 
emit Transfer(msg.sender, to, value); 
return true; 


// 代 币 转账 2 

function transferFrom(address from, address to, uint256 value) public returns (bool success) { 
require( to !- @xð); 
uint256 allowanceValue - allowed[ from][msg.sender]; 
require(balances[ from] >= value && allowanceValue >= value); 
require(balances[ to] + value > balances[ to]); 
allowed[ from][msg.sender] -= value; 
balances[ to] += value; 
balances[ from] -= value; 
emit Transfer( from, to, value); 
return true; 


3-14 “transfer” I "transferFrom" PAŽI 


因为 “transferFrom ”的 转账 方式 涉及 授权 值 ， 所 以 在 参数 判断 阶段 必须 多 出 一 个 授权 值 
“allowanceValue” 和 所 要 转 出 数值 “value” 的 判断 ， 转 出 的 数值 “value ”必须 比 已 经 授权 了 的 值 
小 。 
授权 值 “allowanceValue” 的 设置 在 “approve” 国 数 中 ， 关 于 参数 的 对 应 获取 关系 ， 在 “标准 
的 函数 ”一 节 介 绍 “approve ”函数 时 举 了 一 个 很 通俗 的 例子 ， 以 供 读者 参考 。 
在 参数 判断 通过 后 ， 还 要 进行 同 “transfer” 哨 数 中 一 样 的 余额 修改 操作 ， 即 要 减少 当前 的 授 
BUR SB. 
至 此 ， 一 份 标准 的 ERC20 代 币 的 智能 合约 就 编写 完成 了 ， 其 完整 代码 如 下 : 
pragma solidity ^0.4.23; // 指 定 版 本 
contract MyToken { 
string public name = "My first token coin"; // 代 币 的 名 称 
uint8 public decimals = 18; / 代 币 单位 精确 到 小 数 点 后 的 位 数 
string public symbol = "MFTC"; // 代 币 的 符号 


uint public totalSupply; // 代 币 的 发 行 量 
// 下 面 是 转账 事件 和 授权 事件 


event Transfer(address indexed from, address indexed to, uint256 value); 
event Approval(address indexed owner, address indexed spender, uint256 
value); 
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mapping (address => uint256) public balances; // 余额 映射 

mapping (address => mapping (address => uint256)) public allowed; 

// 授权 映射 

// constructor 是 Solidity 构造 函数 的 关键 字 

constructor() public í( 
totalSupply = 100000000000000000000000000; // 修改 发 行 量 初始 一 亿 
balances[msg.sender] = totalSupply; 

l 

// 根据 地 址 获取 代 币 余额 


function balanceOf(address owner) public view returns (uint256 balance) 


return balances[ owner]; 


} 
// 授权 额度 申请 
function approve (address  spender, uint256 value) public returns (bool 
success) { 
allowed[msg.sender][ spender] = value; 
emit Approval(msg.sender,  spender, value); 
return true; 
} 
// 根据 owner Ñl spender 查询 owner 给 spender 授权 了 多 少 额度 
function allowance (address owner, address  spender) public view returns 
(uint256 remaining) { 
return allowed[ owner][ spender]; 


} 
// 代 币 转账 


function transfer(address to, uint256 value) public returns (bool success) 


require( to !- 0x0); // 不 允许 收 款 地 址 是 零 地 址 
require(balances[msg.sender] »- value); 
require(balances[ to] * value » balances[ tol); 
balances[msg.sender] -- value; 
balances[ to] += value; 
emit Transfer(msg.sender, to, value); 
return true; 

} 

// 代 币 转账 2 

function transferFrom(address from, address to, uint256 value) public 

returns (bool success) { 

require( to !- 0x0); 
uint256 allowanceValue = allowed[ from][msg.sender]; 
require(balances[ from] »- value && allowanceValue »- value); 
require(balances[ to] + value > balances[ tol); 


allowed[ from][msg.sender] -- value; 
balances[ to] += value; 
balances[ from] -- value; 


emit Transfer( from, to, value); 
return true; 


) 


在 这 份 “MyToken.sol” 智 能 合约 中 ， 所 有 实现 了 的 图 数 都 是 ERC20 标准 中 的 图 数 ， 我 们 还 可 
以 在 里 面 添加 一 些 其 他 的 函数 ， 例 如 添加 一 个 返回 总 发 行 量 一 半 的 函数 ， 如 图 3-15 所 示 。 
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// 返回 总 发 行 量 的 一 半 
function getHalfTotalSupply() public view returns (uint half) { 


return totalSupply/2; 


3-15. 在 遵循 合约 标准 的 代码 中 目 定义 函数 


在 合约 编写 和 编译 好 之 后 ， 发 布 阶段 还 要 从 Remix 中 取出 合约 的 Solidity 代码 、 合 约 的 ABI 
和 合约 的 字 节 人 码 (Bytecode) ， 以 便于 在 调用 合约 图 数 时 作为 参数 来 传 参 。 除 了 从 Remix 中 取出 合 
约 的 Solidity 代码 外 ， 后 两 者 的 数据 会 在 下 面 与 合约 的 发 布 相关 的 章节 来 进行 详解 。 


3.4.6 ”合约 的 代码 安全 


因为 智能 合约 是 由 代码 编 写 的 ， 目 然 就 会 存在 代码 漏 洞 方面 的 风险 ， 最 着 名 的 因为 合约 代码 
存在 计算 洲 出 漏洞 而 导致 资产 损失 惨重 的 例子 就 是 2018 年 4 月 份 中 的 “ 美 链 BEC 合约 漏洞 事件 ”， 
该 事件 造成 的 后 果 是 “BEC” 代 币 价 值 归 雯 ， 其 漏洞 代码 如 图 3-16 所 示 。 


255™ function batchTransfer(address[] receivers, uint256 value) public whenNotPaused returns (bool) 1( 
uint cnt = receivers.length; 


balances[msg.sender] - balances[msg.sender].sub(amount); 
for (uinti- 0; i < cnt; iH) ( 


balances[ receivers[i]] = balances[ receivers[i]].add(, value); 
Transfer(msg.sender,  receivers[i], value); 


} 


return true; 


图 3-16 有 漏洞 的 合约 代码 
“batchTransfer” 是 一 个 实现 批量 转账 的 函数 ， 图 3-16 中 框 选 部 分 就 是 有 问题 的 代码 ， 即 


uint256 amount = uint256(cnt) * value; 

其 中 ，“ value” 是 一 个 类 型 为 “uint256” 的 入 参 ， 当 传 入 的 “_ value” 很 大 且 恰 好 还 没有 超 
过 “uint2$6” 最 大 可 表示 的 数值 范围 而 接近 “uint256” 取 值 范围 的 最 大 值 时 ，“_value” 乘 上 
*uint256(cnt)" RARE, 3i *uint256" HEKA gi, HERF “amount” WE — NR 
的 数 ， 不 再 是 正确 的 值 ， 这 将 使 得 后 面 的 判断 条 件 很 容易 被 校 验 通过 。 

当 从 转 币 者 的 地 址 扣除 “amount” 的 时 候 ， 事 实 是 扣 了 很 少 。 

balances[msg.sender] = balances[msg.sender].sub(amount); 

而 在 循环 中 给 “ receivers” 添 加 代 币 数量 的 时 候 ， 却 添加 了 “_value” 的 数值 。 

balances[ receivers[i]] = balances[ receivers[il]].add( value); 


最 终 导 致 扣除 了 很 少 的 “amount” 却 转 给 别人 巨额 的 数值 ， 造 成 资产 被 盗 ! 
解决 这 个 问题 的 方法 是 使 用 安全 的 乘法 方式 ， 以 避免 大 数 注 出 ， 例 如 使 用 如 下 的 乘法 函数 : 
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function mul(uint256 a, uint256 b) internal pure returns (uint256) 1 
if (a == 0) { 
return 0; 


} 
uint256 C= a * b; 
require(c / a == b); 


return c; 


} 

对 于 智能 合约 中 的 加 、 减 、 乘 、 除 运算 ， 以 太 坊 官方 提供 了 一 个 安全 运算 图 数 的 开源 库 ， 链 
接 如 下 : 

https://github.com/OpenZeppelin/openzeppelin-solidity/blob/master/contracts/math/SafeMath.sol 

以 上 只 是 合约 代码 安全 方面 的 例子 之 一 。 在 实际 开发 中 ， 在 复杂 且 涉 及 运算 的 功能 实现 中 一 
定 要 谨慎 编写 代码 ， 以 避免 产生 代码 漏洞 。 


3.5” 链 上 的 合约 


发 布 智能 合约 又 称 把 智能 合约 发 布 到 区 块 链 上 。 智 能 合约 一 旦 发 布 成 功 ， 便 不 能 再 修改 ， 这 
是 一 个 不 可 逆 的 操作 。 所 谓 的 不 能 修改 ， 指 的 是 合约 的 代码 不 能 重新 编写 。 

一 般 来 说 ， 在 把 编写 好 的 智能 合约 真正 发 布 到 公 链 之 前 ， 会 先 将 其 发 布 到 以 太 坊 测试 网 络 的 
测试 链 上 ， 进 行 广泛 的 测试 ， 包 含 bug 点 检测 等 ， 确 保 没 问 题 才 会 发 布 到 公 链 上 。 

如 朱智 能 合约 发 布 到 公 链 后 发 现 依然 存在 问题 ， 怎 么 办 呢 ? 这 种 情况 下 只 能 重新 发 布 一 份 蔡 
换 的 智能 合约 , 并 将 之 前 发 布 的 有 问题 的 智能 合约 宣布 作废 , 新 发 布 的 合约 的 名 称 此 时 就 会 出 现 和 
旧 合 约 的 名 称 一 样 的 情况 ,根据 合约 的 唯一 性 标志 ， 名 称 一 致 没有 关系 ,合约 的 以 太 坊 地 址 总 是 不 
一 样 的 。 图 3-17 所 示 束 是 在 以 太 坊 区 块 链 浏览 需 中 和 输入 ERC20 代 币 名 称 进行 查询 的 时 候 ， 看 到 的 
名 称 相 同 的 代 币 列表 。 


(f Etherscan All Filters — Search by Address / Txn Hash / Block / T E 
EO ee omo Blockchain v Resources ~ X Moro» . OsSianin 


根据 通 证 名 称 搜索 


Token Tracker ERc-20 


Ethereum Token Market Capitalization 


. ERC-721 Top Tokens 
A total of 186,917 Token Contracts found 


View ERC-721 


# ^ Token m |) wMarketCap ? Holders 


图 3-17 名 称 相同 的 代 币 列表 
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ockchain v Tokens v Resources v More v O Sign In 


£3 CDCC (CDCC) 
Change (%) Volume | ERC-20 TOKEN: 
0x78021abd9b06f0456cb9db95a84 .. 
a [| 16% $426.1; https://cdcctop.io/ 
0033337697 Btc 


101400 Eth AC/DC cat (ACDCCAT) 


ERC-721 TOKEN : 


0x33378513b9f9406a43f6b0e 7 ebH .. 
0862873614 Btc 


624512 Eth Clothes Dressing Chain Coin 


ERC-20 TOKEN : 


3-17 CX) 


如 采 还 涉及 问题 合约 对 应 的 代 币 已 经 流通 起 来 了 的 情况 ， 此 时 的 补救 方法 可 以 考虑 : 选择 一 
个 区 块 高 度 ， 以 所 选区 块 高 度 为 准 ， 对 旧 合 约 代 币 的 所 有 持 有 者 〈Holder) 进行 新 合约 代 币 数值 的 
一 一 对 应 的 映射 操作 ， 再 宣布 旧 合约 地 址 作废 ， 合 约 以 新 的 地 址 为 准 。 


3.6 认识 Mist 


和 智能 合约 的 编译 器 Remix 一 样 ， 以 太 坊 也 提供 了 一 个 包含 智能 合约 发 布 功能 的 图 形 界面 钱 
包 ， 名 称 是 Mist， 也 可 称 为 “Ethereum Wallet”“【〔 以 太 坊 钱包 ) 。Mist 是 一 个 开源 软件 ， 并 支持 
Windows(64 位 )、Mac „Linux 三 大 操作 系统 , 它 的 源码 开源 地 址 是 https://github.com/ethereum/mist。 
Mist 安装 包 的 下 载 链接 是 : https://github.com/ethereum/mist/releases。 如 图 3-18 所 示 。 


Ethereum Wallet and Mist Beta 0.11.1 - windows hotfix 


W :eronfaoa released this on 24 Jul - 100 commits to master since this release 


v Assets 18 

O9 Ethereum-Wallet-installer-0-11-1.exe 
CT? Ethereum-Wallet-linux32-0-11-1.deb 
(fh Ethereum-Wallet-linux32-0-11-1.zip 
Cf Ethereum-Wallet-linux64 -0-11-1.deb 
Cf? Ethereum-Wallet-linux64-0-11-1.zip 
(T9 Ethereum-Wallet-macosx-0-11-1.dmg 


C Ethereum-Wallet-win32-0-11-1.zip 


(T Ethereum-Wallet-win64-0-11-1.zip 


CT? Mist-installer-0-11-1.exe 
Cf^ Mist-linux32-0-11-1.deb 
Cf? Mist-linux32-0-11-1.zip 


Cf" Mist-linux64-0-11-1.deb 


3-18 Mist 安装 包 的 下 载 链接 


112 | 区 块 链 以 太 坊 DApp 开发 实战 


Mist 除了 具有 发 布 智能 合约 的 功能 外 ， 主 要 还 是 一 个 以 太 坊 钱包 ， 自 然 会 拥有 钱包 的 创建 、 
备份 以 及 以 太 坊 ETH 余额 查看 、ETH 转账 和 ETH 挖 矿 的 功能 。 

下 面 以 Windows 64 位 的 Mist 版 本 为 例 介 绍 其 启动 方式 ， 首 先 下 载 zip 压缩 包 ， 解 压缩 到 电脑 
中 的 某 一 个 文件 夹 下 即 可 ， 如 图 3-19 所 示 。 


CP Ethereum-Wallet-win64-0-11-1.zip 67.4 MB 


3-19. 要 下 载 的 Mist 版 本 


随后 打开 解压 缩 好 的 文件 夹 ,然后 单 击 “″Ethereum Wallet.exe” 启 动 以 太 坊 钱包 软件 , 如 图 3-20 
所 示 。 


a] d3dcompiler 47.dll 2018/3/16 17:52 ”应 用 程序 扩展 4,077 KB 
O Ethereum Wallet.exe 2018/7/23 16:27 ”应 用 程序 65,885 KB 


图 ffmpeg.dll 应 用 程序 扩展 1.899 KB 
icudtl.dat 37 : AT X 9 804 KB 


320 ”局 动 以 太 坊 钱包 软件 
首次 局 动 会 有 点 慢 ， 稍 等 一 会 儿 就 能 进入 到 主页 面 ， 如 图 3-21 Przn 


Q Ethereum Wallet 
Ethereum Wallet ES RA 视图 F SO WE 


1 


WALLETS SEND SW Remote | £2 6,610500 ® s CONTRACTS O.O l ETHER 


Accounts Overview 


Accounts are password protected keys that can hold Ether and Ethereum-based tokens. They can control contracts, but ca 
coming transactiors 


.. * P ACCOUNT 1 


ADD ACCOUNT 


These contracts are stored on the blockchain and can hold and secure Ether. They can ha 
full log of all transactions. 


321 以 太 坊 钱包 的 主页 面 
下 面 我 们 开始 介绍 Mist 的 主要 功能 及 使 用 。 


3.6.1 TARIR 


ft "Mist" ERA Ef8RiBede Ep. RATI DA EE ARAA XE PERS) DUK BS PP 2 T ns 
切换 方式 为 用 鼠标 依次 单 击 “开发 ”一 “网 络 ”。 
在 所 展示 的 列表 中 ，“ 主 网 络 ” 代 表 的 是 以 太 坊 主 网 ， 在 主 网 站 进行 的 转账 操作 发 生 的 资产 
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变化 都 是 具有 真实 法 币 价 值 的 。“Ropsten ”网 络 代表 的 是 以 太 坊 的 测试 网 络 之 一 ， 顾 名 思 义 ， 测 
试 网 络 中 所 产 生 的 资产 操作 都 属于 测试 性 质 ， 不 被 承认 具有 真实 法 币 价 值 。 所 谓 法 币 价值 ， 就 是 我 
们 日 常 所 使 用 的 法 定货 币 ( 金 钱 ) 的 价值 “Rinkeby” 也 是 以 太 坊 测试 网 络 中 的 一 类 , 它 与 “Ropsten” 
的 区 别 会 在 后 和 面 的 “获取 测试 网 络 节 点 ”一 节 中 进行 讲解 。 


3.6.2 ”区 块 的 同步 方式 


和 “节点 的 切换 ”一 样 ， 在 “Mist” 主 页 左上 角 的 功能 按钮 栏 中 也 可 以 切换 同步 网 络 类 型 链 上 
区 块 的 同步 方式 ， 这 是 什么 意思 呢 ? 

原来 是 “Mist” 软 件 在 选择 好 以 太 坊 网 络 类 型 后 会 目 动 同步 该 网 络 区 块 链 上 的 区 块 ， 将 区 块 存 
放 在 本 地 电脑 ， 以 方便 软件 自身 从 区 块 中 读 取 数据 。 

因为 区 块 链 在 运行 的 过 程 中 ， 伴 随 看 区 块 的 不 断 产生 ， 链 上 的 区 块 越 来 越 多 ， 比 如 目前 以 太 
坊 公 链 区 块 数量 已 经 达到 了 600 多 万 个 ， 面 对 如 此 多 的 区 块 数据 量 ， 如 果 软 件 完 整地 从 0-600 多 
万 区 块 同 步 到 我 们 的 计算 机 ， 这 将 会 非常 耗 时 。 因 此 ， 以 太 坊 的 节点 源码 提供 了 可 以 选择 同步 方式 
的 接口 ， 以 方便 开发 者 根据 需要 作出 选择 。 

执行 “开发 ”一 “Sync mode”， 在 可 选 的 列表 中 提供 了 以 下 同步 方式 : 

e Light 模式 。 轻 节点 模式 ， 策 略 是 只 同步 所 有 区 块 的 头 部 信息 ， 区 块 体 不 同步 下 载 。 

€ Fast 模式 。 快 速 模式 ， 策 略 是 快速 同步 完 所 有 区 块 的 头 部 信息 ， 随 后 根据 每 个 区 块头 同步 对 

应 的 区 块 体 ， 最 终 达 到 完全 同步 的 目的 。 
© Full 模式 。 全 节点 模式 ， 这 个 模式 是 最 耗 时 的 ， 它 将 直接 从 区 块头 开始 完整 同步 区 块 信息 。 
© Mist 默认 选择 的 是 Light 模式 。 


3.7 ”人 刨 建 以 太 坊 线 包 


以 太 坊 智能 合约 的 发 布 ， 存 在 看 一 个 “Creator”《〈 创 建 者 ) 的 概念 ， 这 个 “Creator” 的 意思 
是 指 这 份 智 能 合约 是 由 哪个 以 太 坊 地 址 发 布 的 。 从 交易 的 角度 来 看 ， 以 太 坊 上 每 份 合约 的 发 布 本 质 
上 都 是 发 送 一 笔 交 易 ， 即 “Transaction”。 

显然 ， 有 交易 就 有 交易 发 起 者 ， 而 发 布 智能 合约 交易 的 发 起 者 就 是 “Creator”， 在 合约 发 布 
的 时 候 ， 这 个 地 址 对 应 Solidity 代码 里 面 的 “msg.Sender”， 因 此 要 求 当前 “Creator” 的 以 太 坊 地 
址 拥有 以 太 坊 ETH 代 币 ， 以 便 在 发 布 合约 时 作为 交易 的 手续 费 。 

首先 我 们 跟随 图 3-22 在 Mist 中 创建 一 个 以 太 坊 钱包 来 充当 发 布 智能 合约 的 “Creator”。 单 击 
右上 和 角 功 能 列表 中 的 “账户 ”， 再 单 击 新 建 账户 。 
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| Q Ethereum Wallet 
Ethereum Wallet ES g8 视图 开发 窗口 wi 
新 建 账户 Ctn+N 


9 , N Remote | £2 6,622594 ®© 35 minutes 


Accounts Overview 


322 Æ Mist 中 创建 以 太 坊 钱包 
在 弹出 的 对 话 框 中 ， 输 入 密码 即 可 完成 账户 的 创建 ， 如 图 3-23 所 示 。 


Q Ethereum Wallet 
Ethereum Wallet 账户 编辑 视图 开发 窗口 帮助 


创建 账户 


3-23 ”输入 创建 钱包 的 密码 
在 弹出 的 英文 提示 框 中 提示 如 何 备 份 在 Mist 中 新 建 钱 包 的 方法 ， 如 图 3-24 所 示 。 


| um Wallet 
Ethereum Wallet 账户 Ra 视图 开发 窗口 帮助 


创建 账户 


rotected keys that can H cts, but can't display 


ETENE 


| 


eum Wallet 


Make sure you backup your keyfilles AND password! 


You can find your keyfiles folder using the main menu -> File -> Backup -> Accounts. Keep 
a copy of the "keystore" folder where you can't lose it! 


3-24 ”提示 信息 


备份 钱包 的 流程 是 : 依次 单 击 “ 账 户 ” 一 “备份 ”一 “账户 ”。 按 照 此 流程 操作 后 ， 可 以 看 
到 使 用 Mist 生成 的 钱包 的 “keystore ”文件 所 存放 的 文件 夹 ， 知 道 了 这 个 文件 夹 ， 就 能 把 钱包 的 
“keystore” 文 件 取出 , 之 后 可 将 其 导入 到 其 他 的 钱包 软件 App 中 , 也 可 以 在 开发 时 使 用 , 如 图 3-25 
所 示 。 
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> LinGusnHong > AppData > Roaming » Ethereum 


Ei ~ 修改 日 期 
geth 


2018/6/27 9:27 
keystore 2018/11/1 17:04 


testnet 2018/6/21 16:11 
| | history 2018/6/27 10:18 


« ĦA > LinGuanHong > AppDeta > Roaming > vo 


Ej 3m 

|] UTC—-2018-10-12T02-05-03.8947908002--10.. 2018/10/12 10:05 

|. ] UTC--2018-11-U1T09-03-42.5168575007--0e.. 2018/11/1 17:03 
] UTC--2018-11-01T09-04-09.230994000Z--5«.. 2018/11/1 17:04 


894790800 --10... 
6168575007 -- 


230994)00Z--5C 


325 Mist 创建 的 钱包 所 生成 的 Keystore 文件 


图 3-25 中 的 每 一 个 “keystore” 文 件 都 对 应 一 个 以 太 坊 钱包 地 址 ， 那 么 如 何 区 分 各 个 地 址 呢 ? 
其 实 很 容易 。 例 如 ， 图 3-25 中 有 3 个 以 太 坊 钱包 的 “keystore” 文 件 ， 只 需要 先 观察 每 个 文件 的 名 
称 再 和 我 们 所 知道 的 钱包 地 址 进行 匹配 就 能 区 分 。 当 然 ,， 除了 借助 文件 名 称 来 识别 ， 还 可 以 直接 以 


文本 格式 打开 “keystore” 文 件 ， 在 文件 里 面 也 能 看 到 钱包 地 址 ， 也 就 是 去 挥 了 Ox 后 的 所 有 字符 ， 
如 图 3-26 所 示 。 


名 称 修改 日 期 
| ] UTC--2018-10-12T02-05-03.894790800Z--1000ddcaS5c1babeciaSeSbda060b2e3dd5634da7 
| ] UTC--2018-11-01T09-03-42.6168575002Z--0e0843d8512cdef6c4998eb8d623c540e4241bc8 


| ] UTC--2018-11-01T09-04-09.230994000Z--5c78dí839632dd4ea648bacf2abee5795c4e23e5 
e_O 


2018/10/ 
2018/11/ 


{E "—" $5 55 auf fo e AAD ER Hh h, 
3. uc A Mox A FIF 


3-26 Mist 默认 给 钱包 keystore 文件 的 命名 方式 


拥有 了 “keystore” 文 件 还 不 足以 让 我 们 解锁 这 个 钱包 ， 在 使 用 “keystore” 文 件 解锁 钱包 ， 例 
如 导入 到 钱包 App 的 时 候 ， 还 需要 输入 这 个 “keystore” 文 件 对 应 的 密码 ， 这 个 密码 就 是 我 们 在 创 
建 钱 包 时 输入 的 密码 。 


“keystore” 文 件 及 其 密码 和 钱包 私 钥 、 助 记 词 的 关系 如 下 : 
“keystore ”文件 + 密码 = 私 钥 
“keystore” 文 件 + 密 码 = 助 记 词 
最 后 ， 创 建 完 成 的 钱包 界面 如 图 3-27 所 示 。 每 个 钱包 所 对 应 的 “x.xx ether” 代 表 的 就 是 拥有 
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多 少 个 以 太 坊 ETH 代 币 。 需 要 注意 的 是 ，Mist 显示 的 数值 只 精确 到 了 小 数 点 后 两 位 且 最 后 一 位 小 
数位 是 四 人 铭 五 入 形式 的 。 例 如 ， 如 果 刚 好 有 0.001 Ether， 那 么 在 这 里 看 到 的 是 0.00 Ether， 如 果 刚 
好 有 0.0051 Ether， 那 么 在 这 里 看 到 的 应 该 是 0.01 Ether. 


= © D) 


K A Remote | $ 5,622,594 © an hour CONTRACTS 
钱包 列表 


Accounts Overview 


WALLETS 


Accounts are password protected keys that can hold Ether and Ethereum-based tokens. They can control contracts, but c 


incoming transactions n 所 有 创建 Sg 的 钱包 


. 9 © ACCOUNT 1 © ACCOUNT 2 ~~ © ACCOUNT 3 


We OOl aher 0.00 ete 0.00 «ther 


ADD ACCOUNT famm — 1:7 即 可 创建 钱包 ， 功 能 和 在 账户 中 创建 的 一 样 


3-27 Mist 钱包 列表 界面 


3.8 使 用 Mist 转账 代 币 


创建 好 的 以 太 坊 钱包 ， 除 了 用 来 发 布 智能 合约 ， 还 能 用 来 接收 别人 转 给 我 们 的 以 太 坊 ETH 或 
ERC20 代 币 。 

转账 也 是 Mist 支持 的 一 项 功能 ， 在 主页 面 中 单 击 “SEND” 按 钮 进入 交易 页 面 ， 注 意 ， 这 个 
页 面 既 可 以 进行 以 太 坊 ETH 转账 ， 又 可 以 进行 ERC20 代 币 转账 。 如 图 3-28 所 示 。 


Send funds 
收 款 人 的 以 太 坊 钱包 地 址 
£ Q Account 1 - 001 ETHER 


转账 的 数值 输入 处 V 的 将 要 进行 转账 的 代 币 列表 


© ETHER 0.0056957033948334 ETHER 


Send everything E PCI 


fe want to send 0 ETHER. 


ITEE ERARIS 


SHOW MORE OPTIONS 


328 Mist 的 转账 界面 


图 3-28 中 的 “TO” 代 表 的 就 是 收 称 人 的 以 太 坊 钱包 地 址 ， 必 须 满 足 十 六 进 制 共 42 个 字符 的 
格式 ， 否 则 会 出 错 。 可 选 的 能 够 进行 转账 的 代 币 列表 中 默认 的 第 一 项 是 以 太 坊 ETH， 也 就 是 图 中 
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的 “ETHER”， 可 以 通过 用 鼠标 单 击 来 选择 。 
除了 “ETHER” 之 外 的 选项 都 是 其 他 的 代 币 ， 这 里 的 代 币 不 局 限于 ERC20 代 币 类 。 注 意 ， 选 
择 列表 中 显示 的 其 他 代 币 ， 需 要 满足 下 面 的 两 个 条 件 : 


(1) 代 币 对 应 的 合约 必须 是 用 户 ， 也 就 是 我 们 在 Mist 中 手动 添加 的 “Custom Tokens” OE 
制 代 币 ) ， 可 以 单 击 主页 面 中 的 “CONTRACTS” 按 钮 ， 再 下 滑 到 最 后 ， 单 击 “WATCH TOKEN" 
按钮 ， 手 动 添加 代 币 ， 如 图 3-29 所 示 。 


eum Wallet 账户 5 视图 F 窗口 #3) 
WALLETS SEND Remote | © 6622594 aday CONTRACTS 0.01 ETHER 


\ CONTRACTS 按钮 


Tokens are currencies and other fungibles built on the Ethereum platform. In order for accounts to watch for tokens 


and send them, adi ave Lo add their address to this list. You can create your own token by simply modifying this 
example of a custom token contract or leaming more about Fthereum Tokens 


CDCC PCT PCT 
0.000000 000.. © 333,393,339... $e 1,000,000,00. 


- RA JN 
WATCH TOKEN "7 AUTO-SCAN 


3-29 Mist 中 添加 进来 的 合约 界面 
(2) 必须 是 当前 在 Mist 解锁 了 的 钱包 账号 ， 该 钱包 拥有 数量 大 于 零 的 代 币 。 


说 明 一 下 第 (2) 点 ， 解 锁 了 的 主 钱包 就 是 图 3-29 ZERA “Account 1” 的 钱包 ，“Account 
1” 必 须 拥 有 图 3-29 中 两 个 “PCT” 代 币 的 值 。 这 样 就 满足 了 第 (2) 个 条 件 所 摘 述 的 要 求 ， 如 
图 3-30 所 示 。 


^^ Account 1 


a 


ES PCT 999,999,999.999999999999999980 PCT 


— Pcr 1,000,000,000.000000000000000000 PCT 


3-30 两 个 PCT 代 币 值 


仍然 在 交易 页 面 单 击 “SHOW MORE OPTIONS ”按钮 ， 可 以 看 到 下 面 的 “DATA” 输 入 框 ( 见 
图 3-31) ， 这 里 的 “数据 ”是 可 选 输 入 的 ， 它 具有 下 面 的 特点 : 
必须 是 ETH 转账 的 情况 ， 其 他 代 币 转账 ，Mist 是 不 允许 输入 的 。 
必须 是 十 六 进 制 格式 的 字符 串 ， 否 则 报错 。 
这 里 的 “数据 ”在 代码 层面 对 应 的 就 是 我 们 在 “以 太 坊 交易 ”一 节 中 介绍 的 “data” 参 数 。 
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You can add extra data to send 
along with your transaction. If you 


don't know what this is then don't 
touch it or bad things may 
happen. 


3-31 Mist Æ ETH 交易 情况 下 提供 的 DATA 参数 输入 框 
图 3-32 是 交易 手续 费 的 调节 界面 和 转账 发 送 最 后 一 步 等 待 输入 解锁 密码 的 界面 。 


U.UUol ETHER 


ECAC 
This is the most amount of money that might 0X123AFC45 
0.000318 emer be used to process this transaction. Your 

transaction will he mined probably within 


30 seconds 
CHEAPER 


2 进度 条 调节 燃料 费 ， 越 往 右 越 高 ， 交 易 也 就 越 快 完成 
0.000318 ETHER 


输入 创建 钱包 时 候 
的 密码 


SEND TRANSACTION 


图 3-32 ”交易 手续 费 的 调节 和 输入 解锁 密码 的 界面 
输入 密码 后 按 回 车 键 ， 就 能 进行 交易 了。 交易 发 起 之 后 ， 回 到 Mist 主页 面 ， 滑 动 鼠 标 到 当前 


页 和 面 的 后 和 面 就 能 看 到 每 笔 已 经 发 起 了 的 交易 记录 ， 单 击 交 易 记 录 即 可 查看 交易 详情 ， 如 图 3-33 所 


不 。 


Transaction 


Thursday, November 1, 2018 6:26 PM 
(2 hours ago, -510 Confirmations) * 前 交 易 的 哈 En 
值 ， 单 击 它 将 进 
Amount 0.0001 ETHER A bx Heo Du WC 
的 页 面 
From £ Account 1 


Latest Transactions To @ Account2 


Fee paid 0.000 127224 ETHER 


Gas used 21,204 


aC C 0.0001 " Gas price 0.006 ETHER PER MILLION GAS 
ME Account! + a Account 2 ETHER 


Block 


Contract execution 
3 hours 


"B ago 
4 Account 1 > a Account 2 5 


Send data 


3-33 Mist 中 显示 已 经 发 送 了 的 交易 信息 界面 
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现在 使 用 前 面 “ 区 块 链 浏览 器 ”一 节 中 所 介绍 的 “etherscan.io” 网 址 来 查询 刚刚 测试 中 发 起 的 
ETH 转账 ， 即 图 3-32 中 “data” 设 置 为 “0x123afc455555555555” 的 那 一 笔 。 如 图 3-34 所 示 ， 可 
以 看 到 交易 已 经 成 功 ， 而 且 数 据 都 是 我 们 所 设置 的 那样 。 


Comments 


Transaction Information OG € 


TxHash Ox76f618de3431c50cracacoe918102e0dce8d31712040c38d615D830a39ebD852ecb 
TxReceipt Status: Success 


Block Height: 6623709 (1 Block Confirmation) 


TimeStamp 32 secs ago (Nov-01-2018 12:52:52 PM *UTC) 


0x1000ddca5c1babec1 aS5e5bda0650b2e3dd5634da7 
0x0e08434d8512cdef6c49988b808623c540642415bc8 
Value 0.0001 Ether ($0.02) 
Gas Limit 121000 
Gas Used By Transaction: 21512 (17.86%) 


Gas Price: 0.000000006 Ether (6 Gwei) data 
Ate 


Actual Tx COSUFee: 0.000129672 Ether ($0.03) 
Nonce & {Position}: 18 | (73) 
Input Data 

Qx123a£c455555555555 


334 在 区 块 链 浏览 器 中 查看 交易 的 data 参数 
由 “data” 在 以 太 坊 ETH 转账 结果 的 体现 来 看 ， 我 们 可 以 利用 “data” 来 目 定义 输入 目 己 想 要 
记录 的 数据 ， 然 后 利用 交易 将 这 些 数据 发 送 到 区 块 链 上 ， 这 样 “data” 中 的 数据 就 会 永远 存在 于 区 
块 链 上 。 


3.9 使 用 Mist 发 布 智能 合约 


首先 在 Mist 的 主页 面 单 击 “CONTRACTS” 按 钮 ， 在 显示 的 主页 面 中 单 击 “DEPLOY NEW 
CONTRACT” 按 钮 就 可 以 开始 合约 的 部 署 ， 如 图 3-35 PR. “DEPLOY NEW CONTRACT” 的 中 
文 含义 就 是 部 署 新 合约 。 


(t) aW Remote | £3 6,622,594 [3 
WALLETS (0 a day CONTRACTS 


Contracts / 


CONTRACT 


DEPLOY NEW Lv 署 新 合约 


3-35 ”部 署 新 合约 
图 3-36 表示 的 意思 是 , 在 部 蜀 合 约 的 同时 发 送 多 少 个 ETH 代 币 到 这 个 合约 的 地 址 ， 一 般 保持 
0 个 即 可 ， 因 为 目前 所 有 发 送 到 茶 个 智能 合约 地 址 上 的 ETH 代 币 都 是 拿 不 回来 的 。 智 能 合约 的 以 
太 坊 地 址 虽然 和 钱包 地 址 格式 一 样 ,但 在 部 普 合 约 成 功 后 是 不 会 获得 当前 合约 地 址 所 对 应 的 私 钥 或 
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者 助 记 词 的 。 


Deploy contract 


FROM 


Mi « Account 1 - 0.01 ETHER 


-同时 发 送 多 少 ETH 到 合约 地 址 
AMOUNT xc 
(Æ) ETHER 0.0056957033948334 ETHER 


Send everything 


You wantto send 0 ETHER. 


3-36 Mist 发 送 ETH 交易 的 默认 数值 
在 当前 页 面 继续 往 下 滑动 ， 可 以 看 到 输入 合约 Solidity 代码 的 编辑 杠 ， 以 及 输入 合约 “Byte 
Code” 的 地 方 ， 与 此 同时 ，Mist 还 提供 了 对 这 两 个 编辑 框 中 的 内 容 进 行 校 验 的 功能 ， 例 如 语法 校 
验 ， 如 图 3-37 所 示 。 


SOLIDITY CONTRACT SOURCE CONTRACT BYTE CODE 


pragma solidity ^0.4.18; 
+ contract MyContract 1 


function MyContract() public ( 
aaQqq 


fH VA la 1A 


SOLIDITY CONTRACT SOURCE CONTRACT BYTE CODE 
CODE 


0x1234fggggdl 


N 合约 的 Bytecode 是 16 进 制 数 据 ，g 字母 不 是 16 
进 制 ， 提 示 销 误 


3-37 Mist 的 Solidity 代码 错误 语法 的 提示 


虽然 Mist 为 开发 者 提供 了 使 用 Solidity 语法 编写 智能 合约 的 功能 ， 但 是 笔者 并 不 推荐 这 种 做 
法 ， 建 议 使 用 Remix 进行 智能 合约 的 编写 ， 再 从 Remix 中 提取 出 相应 的 内 容 ， 复 制 到 Mist 上 述 两 
个 输入 框 中， 然后 进行 合约 的 部 署 。 

此 时 ， 需 要 提取 出 在 Mist 发 布 合约 用 到 的 核心 信息 ， 包 括 合 约 的 Solidity 代码 、 合 约 的 ABI 
和 合约 的 Bytecode〈 字 节 码 ) 。 下 面 介 绍 这 些 信 息 的 提取 方法 。 
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3.9.1 合约 Solidity 源码 


仍 以 “实现 加 法 程序 ”一 节 中 的 加 法 智能 合约 为 例 。 在 编译 通过 后 ， 如 果 要 使 用 Solidity 的 代码 ， 
可 直接 从 Remix 的 编辑 框 中 提取 ， 提 取 后 再 粘贴 到 Mist 的 Solidity 代码 输入 框 中 ， 如 图 3-38 所 示 。 

这 种 直接 复制 Solidity 代码 的 操作 是 最 简单 的 ， 但 也 存在 问题 ， 特 别 是 对 于 代码 量 多 、 复 杂 度 
高 的 智能 合约 ， 不 建议 使 用 直接 复制 的 方式 编 诺 发布。 问题 是 这 样 的 : 在 Remix 中 按照 ERC20 标 
准 编写 好 了 Solidity 后 ， 复 制 粘贴 到 Mist 发 布 ， 发 布 成 功 后 ， 到 区 块 链 浏 览 器 https://etherscan.io/ 
中 查看 刚 发 布 成 功 的 合约 ， 会 发 现 少 了 “Read Contract” 文 字 按 钮 ， 如 图 3-39 所 示 。 


browser/MyToken.sol browserl/test.sol * 


pragma solidity ^0.4.23; 


~ contract Test { 


/ 输入 两 个 参数 
function add(uint8 argl,uint8 arg2) public pure returns (uint8) ( 
return argi«arg2; 


SOLIDITY CONTRACT SOURCE CODE CONTRACT BYTE CODE 
1 pragma solidity ^0.4.23; 
2 
3 
4v contract Test ( 


7 ~ function add( t8 a j t8 arg2) public pure returns (uint8) { 
return argl-arg2; 


338 将 Remix 中 编写 好 的 合约 代码 复制 到 Mist 中 


Total Supply: 1 ACDCCAT Contract 0x33378513b9f9406a4316b0e7cbb 
Holders 1 addresses Social Profiles: Not Available, Update ? 
Transfers. 1 


Transfers Holders Inventory Info Read Contract | Write Contract Comments 


信息 提示 无 法 显示 智能 台 约 的 代码 


3-39 ”在 区 块 链 浏览 器 中 无 法 显示 智能 合约 代码 


原因 是 合约 的 编译 器 版 本 问题 导致“etherscan.io” 不 能 根据 Mist 发 布 合约 的 “Bytecode” 识 
别 出 这 是 一 份 符 合 ERC20 标准 的 代 币 合约 。 出 现 这 种 情况 ， 只 能 手动 恢复 ， 或 者 使 用 后 续 介 绍 的 
“Bytecode” 方 式 在 Mist 中 发 布 合约 。 
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在 Mist 中 填写 好 了 “Solidity” 代 人 码 之 后 ， 直 接 单 击 页 和 面 抵 部 的 “DEPLOY ”按钮 进行 合约 的 
WE. WR 3-40 所 示 。 部 署 的 本 质 就 是 发 起 一 笔 交 易 〈Transaction) 。 等 待 以 太 坊 矿工 打包 成 功 
后 ， 合 约 就 部 蓟 成功 了 ， 并 能 在 以 太 坊 区 块 链 浏览 器 上 查询 到 。 


SELECT FEE 
This is the most amount of money that might be 
0.0006 ETHER used to process this transaction. Your transaction 
will be mined usually within a minute. 


CHEAPER FASTER 


和 转账 时 一 样 ， 要 选择 燃料 费 


TOTAL 


0.0006 ETHER 


一 单 击 部 署 按钮 ， 部 署 合 约 


3-40 Mist 中 部 署 合约 也 要 选择 人 燃料 费 


3.9.2 ÅR “ABI” 


智能 合约 中 的 “Application Binary Interface” 人 简称 为 “ABI”， 中 文 全 称 是 “应 用 程序 二 进 制 
接口 ”。 它 的 直观 形式 是 一 串 “Json” 了 字符 串 ，“Json” 里 面包 含 下 耐 的 一 些 “Key”: 

* name， 字 符 串 类 型 ， 对 应 的 是 当前 项 的 名 称 。 注意， 根据 name 只 能 知道 这 个 项 的 名 称 ， 
竟 对 于 它 是 函数 function 还 是 一 个 uint8 的 变量 并 不 清楚 。 

e type， 字 符 串 类 型 ， 标 明 当 前 的 项 是 什么 类 型 ( 是 函数 还 是 一 个 单纯 的 变量 ) 。 常 见 的 type 
有 下 面 的 取 值 : 
> function xk, 
> constructor 构造 函数 。 
> event 事件 。 
> 变量 类 型 ， 例 如 address. uint256. bool 等 。 

e constant， 布 尔 类 型 ， 代 表 当 前 项 的 操作 结果 是 否 会 被 写 入 到 区 块 链 上 ， 是 则 为 tue， 反 之 为 
false。 

e stateMutability， 字 符 串 类 型 。stateMutability 拥有 下 面 的 取 值 : 
> pure， 代 表 不 会 读 和 写 区 块 链 状态 。 
> view， 代 表 会 读 区 块 链 状态 ， 但 不 会 改写 区 块 链 状态 。 
> nonpayable， 代 表 会 改写 区 块 链 状 态 ， 例 如 转账 transfer 和 授权 approve 这 两 个 ERC20 标 

准 的 函数 就 可 以 用 来 改写 区 块 链 。 

€ payable, 布尔 类 型 ， 代 表 当 前 的 函数 function 是 否 可 以 接收 ETH 代 币 ， 可 以 则 为 true， 和 否则 
为 false， 一 般 来 说 都 是 false。 

e inputs， 其 类 型 是 Json 数组 ， 代 表 当 前 项 入 参 的 信息 ， 内 部 会 把 每 个 参数 的 名 称 及 其 所 对 应 
的 类 型 列 出 。 一 般 来 说 ，inputs 会 跟随 type 是 函数 function 或 者 事件 event 而 含有 值 。inputs 
中 的 Json 变量 除了 name 和 type 之 外 ， 还 有 下 面 两 个 变量 : 


e 


第 3 章 智能 合约 的 编写 、 发 布 和 调用 | 123 


> Indexed, Æ Solidity 代码 的 事件 event 中 ， 其 入 参 有 设置 为 Indexed 关键 字 ， 此 时 Json 中 
的 这 个 变量 对 应 的 值 为 tue， 反 之 为 false。 
> components, 该 变量 的 类 型 是 Json 数组 ， 当 参数 的 type 是 struct 结构 类 型 时 , 该 变量 就 会 


出 现 。 
€ outputs, $= inputs 的 含义 类 似 ， 其 类 型 也 是 Json 数组 ， 代 表 的 是 当前 项 的 返回 值 ， 内 部 表达 
是 返回 值 的 名 称 和 类 型 。 


inputs 和 outputs 如 果 没 有 值 ， 便 会 默认 地 显示 为 [ ]。 


€ anonymous， 布 尔 类 型 ， 它 和 “标准 的 事件 (Event) ”一 节 中 介绍 的 “Indexed” 的 设置 有 关 
联 ， 当 为 true 的 时 候 ， 在 “event” 中 的 入 参 即 使 是 属于 “Indexed” 关 键 字 的 形式 也 不 会 保存 
到 “Topic” 中 ， 反 之 则 会 。 


下 面 是 一 个 “ABI” 的 部 分 展示 。 根 据 以 上 对 “ABI” 各 部 分 的 认识 可 知 ， 如 果 知 道 了 一 份 智 
REITZ “ABI” KJ Json， 那 么 也 就 能 了 解 整个 智能 合约 内 部 代码 所 实现 的 函数 、 事 件 、 变 量 等 信息 。 

同时 ， 在 以 太 坊 源码 中 一 般 用 “ABI” 来 做 合约 在 代码 层面 的 预 初始 化 ， 在 准备 调用 合约 的 图 
数 时 ， 可 以 先 判 断 国 数 名 称 是 否 存 在 、 入 参 拓 型 是 否 匹 配 等 操作 。 

[ 


"constant": Erue, 
"Gnpits"s: TIS 
"name": "getHalfTotalSupply", 
"ünbpuES" s | 
| 
"name": "hoarr?. 
"Lype": "uint256" 
) 
], 
"payable": false, 
"StateMutability": "view", 
"Cypers "runction" 


"constant": true, 
"3tipuES"; c ET. 
"name"; "name", 
TOn POES ol 
{ 
"name"; "", 
"Eypa" "SEF1ng" 
} 
], 
"payable": false, 
"StateMutability": "view", 
"Lype": "function" 


"Constant": false, 
"inputs": T 


{ 
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"name"; " spender", 
"Lype": "address" 
fy 
{ 


"name": " value", 
"Lype": "gint256" 
| 
], 
"name"; "approve", 
"nutpubs"s T 
{ 
"name"; "success", 
"Lype": "bool" 
} 
], 
"payable": false, 
"stateMutability": "nonpayable", 
"Lvpe": "runction" 


), 


3.9.3 提取 ABI 和 Bytecode 


在 Mist 智能 合约 发 布 界面 的 另 一 个 输入 框 “CONTRACT BYTE CODE” 中 ， 并 没有 要 求 输入 
“ABI”， 只 和 需要 输入 “Bytecode”《【 了 字 节 码 ) ， 但 是 在 其 他 的 一 些 智 能 合约 发 布 工具 软件 中 ， 需 
要 用 到 合约 “ABI” 人 信息， 包括 在 “geth” 以 太 坊 节点 程序 的 控制 台中 进行 合约 发 布 的 情况 也 需要 
"ABI". 

除了 在 合约 发 布 的 时 候 用 到 “ABI” 之 外 ， 在 代码 层面 的 开发 中 也 会 用 到 ， 这 部 分 内 容 将 在 后 
面 的 中 继 开 发 一 章 中 讲 到 。 

首先 在 Remix 主页 的 右边 工具 栏 上 单 击 “Compile”， 再 单 击 “ABI” 按 钮 进行 ABI 文本 的 复 
制 ， 如 图 3-41 所 示 。 


Current 
version:0.4.25«commit 58dbfBf1 Emscripten 
ciang 


Select new compiler version 


凡 击 复制 ABI 


#) Auto complle Enable Optimization 
Hide warnings 


© Stari to compile 


= Swar 
m 


E Bytecode 


341 在 Mist 中 复制 出 智能 合约 的 ABI 数据 
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接 下 来 提取 “Bytecode”。“Bytecode” 的 提取 不 能 直接 单 击 图 3-41 中 的 “Bytecode ”按钮 进 
行 复制 ， 应 该 单 击 “Details” 按 钮 进入 到 详情 页 面 ， 如 图 3-42 所 示 。 详 情 页 和 面 中 会 显示 出 当前 编 
详 成 功 的 智能 合约 的 所 有 信息 。 
Select new compiler Version v 


+) Auto compile J Enable Optimization 
Hide warnings 


© Start to compile 


不 能 单 击 这 个 按钮 进行 复制 


Swar 


单 击 Detai1ls 按 钮 — ^. ML 


3-242 在 Mist 中 复制 出 智能 合约 的 Bytecode 数据 
单 击 “Details” 按 钮 后 ， 在 阐 出 的 页 面 中 ， 清 动 鼠 标 和 直至 看 到 “WEB3DEPLOY” 栏 ， 找 到 里 
面 实例 中 的 “data” 了 字段 对 应 的 内 容 ， 这 就 是 我 们 要 提取 的 “Bytecode”， 它 是 一 串 完整 的 十 六 i 
制 字符 串 ， 双 击 之 进行 复制 即 可 ， 如 图 3-43 所 示 。 


wEB3DEFLOYN*5 © 


var nytckenConirzsct = vebl. eth. conizsct([[ constant" ;true inputs :[], name": zetHal£TotzslSupply , “outputs” :[[ nane" : "ha 
var nytoken = nytobkenContrsct.nev[ 


cn: web?, eth ounte [0 
data: 'Ox308060405260 408051928 10190 4052806013815200200172447020000972737420 746 £0b35062200 362696600000000000000000000 
DTE 


zasi 4/00 
], function (e, contract) [ 
console, log le, contract]: 
if (typeof contract. address |— '"undefined') | 
console. log (' Contract mined! address: ”二 cofiract.sddress + ° irsnsactionlssh: ”十 contract. iransactionHash]); 


复制 data 内 容 ， 它 才 是 我 们 要 取得 Bytecode 字段 


3-43 Bytecode 字段 的 内 容 


3.9.4 使 用 Bytecode 发 布 合 约 


推荐 在 Mist 中 使 用 “Bytecode” 部 署 智能 合约 ， 这 样 能 够 在 很 大 程度 上 避免 由 于 Remix 编译 
器 版 本 和 Mist 编译 器 版 本 不 同 而 导致 的 问题 ， 即 使 发 生 了 图 3-39 所 提 到 的 问题 ， 也 能 方便 地 进行 
纠正 ， 无 须 重 新 发 布 奉 换 的 合约 ， 如 图 3-44 所 示 。 


SOLIDITY CONTRACT SOURCF CODF CONTRACT BYTE CODE 


0x6080604052348015810010576000801d5b5080a780610011600039 
6000130060806040526004361060365 763fffffffr c0 10000000000000 
000000000000000000000000000000000000000000060003504 1663 

bb4e3f4d8 1146043575b6000801d5b348015604e57600080fd505060 T" 
6160116004358116900024351600775650004080510010921682525 — | 以 粘贴 方式 输入 


19081900360200190f35b01905600a165627a7a72305820aa5c45fae 合约 的 Bytecode 
c15a4d6345/ebb46c4650 / / e370f4c5322a0a05b562b56c41618989abccO 
029 


3-44 ”以 粘贴 方式 输入 合约 的 Bytecode 
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填 好 了 “Bytecode” 后 ， 直 接 单 击 “DEPLOY ”按钮 发 起 部 署 合 约 的 交易 。 人 
页 面 中 ， 可 以 看 到 交易 中 的 “to” 地 址 名 称 变 成 了 “Create contract”， 如 图 3-45 所 示 。 其 实 “t 
如 果 没 有 设置 值 (“to” 地 址 不 填 的 话 ) ， 那 么 在 我 们 发 起 交易 的 时 候 这 个 交易 就 是 创建 合约 。 这 
一 点 在 以 太 坊 的 源码 中 已 经 做 了 声明 。 当 然 ， 如 果 我 们 在 软件 〈 例 如 一 个 钱包 的 转账 页 面 ) 中 不 填 
写 “to” 地 址 ， 就 会 报错 。 这 个 报错 是 开发 者 自行 设置 的 。 


type txdata struct { 

AccountNonce uint64 “json: "nonce" gencodec:"required"' // EGR HAG 

Price *big.Int “json: "gasPrice" gencodec: "required" // gasPrice 
GasLimit uintea !json:"gas" puce rarum // gasLimit 

// to ZAPI Iu, “nil means contract creation" f CEA A, SEREGE pE AH 
Recipient *common. Address[ json:"to"] rlp:"nil"' 
Amount *big.Int Fe "value" gencodec:"Fequired" // ER 3, 
Payload []byte “json: "input" gencodec:"required"  // data ra 


// Signature values 
// Füllivrs AEEA HIE RERUN, IK f 
fe Int 'json:"v" gencodec:"required"' 
R *big.Int 'json:"r" gencodec:"required"' 
S *big.Int 'json:"s" gencodec:"required"' 


// This is only used when marshaling to JSON. 
Hash *common.Hash 'json:"hash" rlp:"-'" 


Create contract 


E 0.00 m [5 


0x1000...4da7 Create contract 


You are about to create a contract from the provided data. 


Estimated fee consumption 0.000682 19 ether (97,455 gas) 
Provide maximum fee 0.00138219 ether (197,455 gas) 


Gas price 0.007 ether per million gas 


RAW DATA 输入 当前 钱包 密码 
a Jd: , 单 击 


3-45 ”以 太 坊 Go 源码 中 对 to 地 址 的 注释 和 Mist 发 起 部 署 合 约 时 候 的 界面 


稍 等 一 段 时 间 ， 在 “Latest Transactions” 栏 可 以 查看 到 合约 的 交易 已 经 成 功 ， 如 图 3-46 所 示 。 
接 下 来 ， 我 们 到 区 块 链 浏览 器 “etherscan.io” 上 进行 查询 验证 。 首 先 在 Mist 上 面 的 交易 详情 
页 面 复制 哈 希 (hash) 值 ， 然 后 用 浏览 器 打开 “etherscan.io ”进行 搜索 ， 如 图 3-47 所 示 。 
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Saturday, November 3, 2018 4:08 PM 


(a minute agn, -31 Contirmations) 


0.00 ETHER 


E Account 1 


To © Created contractat $$ : Test 339d 
Fee paid 0.000682 185 ETHER 

Gas used 97,455 

Gas price 0.007 ETHER PER MILLION GAS 


5634647 


Block 0x08b2d3353639188ddcd 143a65ed2cf69c6ceab... 


P 


0000000000000000000000000000000000000000000000060 


(fo Etherscan Home Blockchain v Tokens v Resources v More v 6 Sign In 


Feature Tip: Track historical data points of any address with the new analytics module! 


Ethereum Blockchain Explorer Quicklinks: ERC-20 Tokens ERC-721 Tokens 


AllFiters ~ 0xabaa39687088cc4f9d12695b17b06b6b712061453b7cb5057a89c8fea0b26d30] MA 27 £y hash 值 进 行 搜索 


ETHER PRICE «ex; LATEST BLOCK TRANSACTIONS ETHEREUM TRANSACTION 
$ $25124 @ 0.03188 BTC (17 64 7770810 (1325) 447.74 M (117 TPS) DAYS 


ransaction Details 
Sponsored: gan Ride the Bull during the ICO of the Best Online Game - Play Now! 
Overview State Changes | New | Comments 
Status: SUCCESS 显示 这 笔 部 闭合 约 的 交易 已 经 成 功 
Block 6634647 1136171 Block Confirmations 
Timestamp © 194 days 2 hrs ago (Nov-03-2018 08:08:40 AM +UTC) 


From: 0x1000ddca5c1babecia5e5bda060b2e3dd5634da7 (à 


To: [Contractfox339dbb357e3bd3c349a912ac3a5a6d4079216911 Created] © 0 


OEther ($0.00) 


3-7  fUÉ BEA T FEASTADSENUTIAE Zo fr e. 
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根据 “etherscan.io” 显 示 的 结果 ， 可 以 确认 上 面 的 合约 已 经 成 功 发 布 到 了 以 太 坊 的 公 链 上 。 合 
约 的 以 太 坊 地 址 是 : 
0x339dbB357E3BD3c349a912ac3a5A6D4079216911 


该 地 址 就 是 合约 的 唯一 标识 。 如 果 要 发 布 “ERC20” 标 准 的 代 币 智能 合约 ， 模 念 上 述 的 发 布 
方法 即 可 。 


3.9.5 ”使 用 合约 的 函数 


在 上 面 的 一 节 中 ， 我 们 使 用 Mist 发 布 了 一 个 实现 加 法 运算 的 智能 合约 ， 那 么 在 智能 合约 发 布 
之 后 ， 如 何 使 用 这 份 智能 合约 呢 ? 

Mist 为 我 们 提供 了 直接 调用 智能 合约 函数 的 页 面 ， 如 图 3-48 所 示 。 首 先 在 Mist 主页 面 上 单 击 
“CONTRACTS” 按 钮 ， 进 入 到 Mist 已 经 发 布 或 者 添加 了 合约 的 列表 页 面 ， 再 找 出 我 们 想 要 调用 
的 函数 的 合约 ， 单 击 合约 可 进入 到 对 应 的 详情 页 面 。 


WALLETS SEND A Remote | 登 6646815 (O8minutes CONTRACTS 


Contracts pe 


单 击 合 询 合约 列表 
DEPLOY NEW 
CONTRACT 


Custom Contracts 选择 想到 使 用 的 合约 ， 然 后 单 击 之 


To watch and interact with a contract already deployed ag the blockchain, you need to know its address ani 
description of its interface in JSON format 


D :DEMO TYPE... : D PCT (ADMIN P... 
0.00 ether J 0.00 ahe 0.00 ether 


9 
3-48 在 Mist 中 选择 要 使 用 的 合约 


在 的 认 情 况 下 ， 我 们 在 合约 列表 页 面 看 到 的 都 是 目 己 在 Mist 上 成 功 发 布 了 的 合约 。 如 果 想 调 
用 别人 发 布 的 合约 ， 怎 么 办 呢 ? 这 种 情况 下 需要 手动 添加 ， 添 加 流程 和 添加 “Custom Tokens” 的 
方法 大 同 小 异 。 

首先 在 合约 列表 中 单 击 “WATCH CONTRACT” 按 钮 ， 在 弹出 的 页 面 中 按照 图 3-49 的 指示 输 
入 对 应 的 信息 ， 其 中 “JSON INTERFACE” 就 是 我 们 前 面谈 到 的 “ABI”， 如 果 要 获取 的 “ABI” 
无 法 从 合约 编辑 器 〈 例 如 “Remix”) 中 获取 ， 可 以 直接 在 区 块 链 浏览 器 《例如 “etherscan.io”) 
中 查询 获取 ， 前 提 是 必须 知道 要 查询 合约 的 以 太 坊 地 址 。 

例如 ， 要 添加 的 智能 合约 是 代 币 “CDCC” 的 ， 知 道 它 的 以 太 坊 地 址 是 : 

0x78021abd9b06f0456cb9db95a846c302c34f£8b8d 
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Watch contract 


CONTRACTADDRESS ， 在 这 输入 合约 的 以 太 坊 地 址 


/ 


CONTRACT NAME j ` 
输入 合约 名 称 


输入 合约 的 ABI 


349 在 Mist 中 查看 合约 的 信息 
现在 到 “etherscan.io” 中 查询 ， 在 查询 出 来 的 页 面 中 单 击 “Code” 按 钮 ， 如 图 3-50 Pr. 


LOGIN Ox78021aD09bDO6I0456CD90D95a846C30 EE co | Language 
BLOCKCHAI TOKENS v RESOURCES v MORE ~ 

Home / Accounts / Address 

输入 合约 的 以 太 坊 地 址 进行 查 忆 


D instruments (BTC, EUR, GOLD, OIL, SHARES). Leverage up to 1:500. OPEN ACCOUNT 


g Misc: More Cptions RA 


Address Watch: Add To Watch List| 


S0 Contract Creator 0x28de3ba33a3... at xn Ox4fc1c491cfeb . 
7452 ixns Token Balance: View ($0.00) = OF 


单 击 Code 按 钮 


xns Read Contract Write Contract ^^? Events Comments 


图 3-50 ”在 “etherscan.io” 中 查询 合约 


然后 在 对 应 的 页 面 中 滑动 鼠标 ， 找 到 “Contract ABI” 一 栏 ， 复 制 “ABI” 的 内 容 ， 这 就 是 我 
们 要 粘贴 到 “JSON INTERFACE” 里 面 的 内 容 ， 最 后 单 击 “OK ”按钮 即 成 功 添 加 别人 发 布 的 合约 ， 
如 图 3-51 所 示 。 


找到 这 栏 ， 然 后 复制 下 面 的 ABI 
[(1"constant":true, "1nputs":[], "nane" :"reserveSupply", "outputs": [["name":""," 
ty" :"view","type":"function"l,["constant" true, "inputs" : [], "name" : "name", "o 
alse,"stateMutability" : "view", "type" :" function"),(" constant" :false,"inputs" 


value","type";"uint256")]],"name":;"approve", "outputs"; [("name":"success", "typ 
onpayable","type":"function"L,["constant":talse,"inputs":[["name": "value", "1 
s":[],"payable":false,"stateMutability":"nonpayable", "type":" function"), ["cq 
utputs":[["name";"", "type":"uint256")], "payable":false,"stateMutability":"v 

s":[i"name":" from","type":"address"3,["name":" to","type": "address" ?,["namaq 


Am" "mnutnnte" fF [naama ": "ernrerancrr" "una" "hanal "ll ”nnrnh1mn falra "etataMuta 


3-51 找到 ABI 的 内 容 复制 
单 击 了 想 要 调用 的 合约 之 后 ， 在 显示 出 的 页 面 中 就 能 看 到 当初 在 合约 中 所 有 定义 好 了 的 能 够 


被 外 部 调用 的 函数 ， 因 为 我 们 要 调用 的 是 加 法 合约 中 的 加 法 函数 ， 所 以 会 看 到 如 图 3-52 所 示 的 界 
面 。 尝 试 分 别 输 入 “Argl1” 和 “Arg2”， 可 以 看 到 该 合约 的 计算 结果 。 
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WALLETS 


时 :TEST339D 


， 就 是 我 们 定义 在 合约 中 的 方法 


3-52 在 Mist 调用 合约 的 函数 


其 他 智能 合约 在 Mist 中 的 调用 流程 和 本 例 相 同 ， 不 再 奖 述 。 
截 公 目前， 我 们 只 是 在 界面 化 的 层面 直接 调用 了 合约 中 的 函数 ， 实 际 开发 中 更 多 的 是 通过 代 
码 来 进行 智能 合约 相关 函数 的 调用 ， 相 关内 容 我 们 将 在 第 4 ETTA. 


3.10 小 结 


以 太 坊 智能 合约 是 目前 以 太 坊 DApp 的 主要 实现 形式 ， 我 们 可 以 通过 发 布 一 份 智能 合约 来 发 
布 一 个 DApp 应 用 。 本 章 从 智能 合约 使 用 的 完整 流程 开始 ， 介 绍 了 如 何 使 用 Remix 编写 智能 合约 
以 及 使 用 Mist 发 布 智能 合约 。 

需要 注意 的 是 ,在 编写 合约 方面 ,并 没有 从 合约 的 Solidity 编程 语言 方面 进行 讲解 (有 关 Solidity 


9 能 合约 是 其 中 一 个 最 为 简单 的 入 门 级 例子 ,通过 该 例 可 以 帮助 我 们 认识 智能 合约 是 一 个 使 用 代码 
编写 的 程序 的 本 质 。 在 加 法 例子 之 后 结合 工具 软件 ， 对 经 常 被 用 于 以 太 坊 上 发 币 所 使 用 的 ERC20 
标准 代 币 合约 的 实际 应 用 进行 了 详细 介绍 , 包括 在 Remix 编辑 器 中 进行 代 币 合约 的 Solidity 代码 编 
写 ， 以 及 得 到 ERC20 代 币 合约 的 “Bytecode” 后 再 使 用 Mist 进行 发 币 等 内 容 。 


在 前 面 各 章 中 ， 我 们 主要 介绍 的 是 以 太 坊 DApp 开发 的 相关 基础 知识 ， 从 本 章 开 始 ， 我 们 将 
通过 一 个 DApp 开发 实例 一 一 以 太 坊 中 继 , 对 这 些 知 识 进行 综合 应 用 ， 以 帮助 读者 掌握 如 何 自 己 动 
手 开 发 DApp 项 目的 实用 技能 。 

本 章 首 先 介绍 以 太 坊 中 继 的 基础 接口 及 相关 概念 ， 在 下 一 章 我 们 将 会 深入 讲解 以 太 坊 中 继 的 
应 用 开发 。 


4.1 认识 以 太 坊 中 继 


首先 ,我们 来 认识 一 下 以 太 坊 中 继 。 通 过 如 图 4-1 我 们 可 以 看 出 以 太 坊 中 继 器 〈 以 下 简称 为 中 
继 ) 在 基于 服务 架构 中 的 位 置 。 
以 太 坊 中 继 在 服务 集群 中 充当 的 是 一 座 连 接 传 统 服务 器 端 和 以 太 坊 区 块 链 的 桥 粱 ， 也 可 以 看 
作 是 服务 分 离 的 一 部 分 。 中 继 负 责 公 链 上 相关 功能 的 实现 ， 几 平台 括 了 目前 以 太 坊 DApp 的 绝 大 部 
分 功能 。 
以 太 坊 中 继 能 够 直接 提供 但 不 限于 下 面 的 功能 : 
e 接受 其 他 服务 端 链 上 的 相关 服务 请 求 ， 然 后 查询 被 请 求 的 链 节 点 ， 获 取 对 应 的 数据 后 再 返回 
给 请 求 的 服务 者 ， 例 如 交易 记录 的 查询 、 代 币 余 额 查 询 等 。 
e 发 起 交易 的 功能 ， 包 括 以 太 坊 ETH 转账 和 ERC20 代 币 转账 。 这 项 功能 经 常 出 现在 目前 交易 
所 开发 的 应 用 中 ， 一 般 对 应 用 户 的 提 币 操作 ， 用 户 在 移动 端 发 起 提 币 请 求 ， 传 统 服务 器 接收 
请 求 后 ， 在 内 网 中 访问 以 太 坊 中 继 ， 把 交易 信息 发 给 中 继 ， 然 后 中 继 从 交易 所 的 对 公 账 户 中 
转 出 对 应 数量 的 币值 。 
e 用 户 以 太 坊 钱包 的 创建 。 这 个 功能 一 般 对 应 于 中 心 化 交易 所 帮助 用 户 在 服务 器 端 创建 钱包 的 
功能 ， 也 是 目前 常见 的 功能 。 
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e 对 链 上 区 块 相关 事件 的 监听 。 该 功能 特别 重要 ， 其 中 也 包含 了 我 们 在 智能 合约 一 节 中 所 谈 到 
的 交易 结果 是 否 被 成 功 监 听 。 目 前 能 够 监听 的 事件 包括 但 不 限于 下 面 的 各 项 : 
> ERC20 代 币 授权 “Approve” 事 件 。 
> 代 币 转账 “Transfer” 的 结果 事件 。 
> WETH 代 币 置换 ETH 事件 。 
> ETH 置换 WETH 代 币 事件 。 
> 新 区 块 生成 事件 。 
> 遍历 完 一 个 区 块 事件 。 
> 区 块 链 分 又 事件 。 


1. 代理 转发 请 求 
2. 监听 链 上 事件 
例如 链 分 又 。 
DAID 22 / 私 链 
3. 其 它 
直接 访问 链 节 点 
以 太 坊 中 继 串 RPC 接 口 获取 数据 
通过 中 继 芯 
T" o MENS 
传统 服务 端 Server 
[ ^ 
E 


4-1 以太 坊 中 继 


以 上 是 常见 的 以 太 坊 事件 ， 具 体 的 还 有 很 多 ， 例 如 在 “标准 的 事件 (Event) ”一 节 中 提 到 的 
一 一 使 用 Solidity 编写 智能 合约 的 时 候 可 以 定义 自己 想 要 的 “Event” 事 件 ， 也 就 是 说 ， 以 太 坊 中 继 
还 可 以 监听 “ 自 定 义 事件 ”等 。 


4.2 ”区 块 志 历 


在 中 继 可 实现 的 功能 中 ， 事 件 的 监听 是 开发 难度 最 高 的 ， 因 为 其 他 的 以 太 坊 接口 调用 如 果 不 
考虑 服务 分 离 ， 可 以 并 入 到 传统 服务 需 端 的 功能 模块 中 去 。 

事件 监听 的 技术 原理 主要 是 通过 获取 一 个 区 块 内 部 的 交易 信息 并 解析 交易 信息 内 的 “Event 
Log”《 事 件 日 志 ) 来 达到 目的 。 在 以 太 坊 目前 提供 的 Web3.js 库 中 ， 有 区 块 事件 的 监听 函数 ， 但 
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Web3.js -HFA m. HFEA FAE: 

(1) 如 果 客 户 端的 进程 被 杀 死 ， 监 听 动 作 就 会 于 失 。 

(20 大 没 对 上 次 最 后 届 历 成 功 的 区 块 号 进行 存储 ,重新 启动 的 时 候 将 会 迁 成 时 间 段 内 新 生成 
区 块 的 数据 丢失 。 

(3) 完整 的 监听 流程 比较 消耗 客 尸 问 的 设备 资源 ， 影 响 用 尸体 验 。 


因此 ， 区 块 的 志 历 及 其 内 部 数据 获取 后 的 存储 应 该 在 后 器 服务 中 进行 ， 也 就 是 以 太 坊 中 继 占 
应 该 包含 该 功能 。 

为 什么 一 定 要 有 监听 区 块 事件 的 功能 ?下 面 我 们 通过 一 个 在 交易 所 中 实际 用 到 的 例子 来 进行 

中 心 化 交易 所 基本 都 具备 用 户 提 币 〈 提 现 ) 的 功能 。 这 里 的 提 币 指 的 是 把 币 从 交易 所 转 到 用 
户 公 链 上 的 钱包 地 址 中 去 ， 坚 无 疑问 ， 这 是 一 个 涉及 在 公 链 中 发 送 交 易 的 操作 。 我 们 知道 ， 以 太 坊 
的 交易 不 会 马上 知道 刚 发 送 的 交易 是 否 成 功 或 失败 ,只 能 够 知道 一 笔 交 易 的 哈 希 值 , 但 是 在 用 户 发 
起 提 币 请 求 后 , 人 工 审核 发 起 转账 , 衣 定 要 在 茶 一 个 时 间 点 通知 客户 端 或 者 数据 库 有 关 转 账 请 求 的 
状态 更 新 ， 例 如 把 提 币 请 求 更 新 为 提 币 成 功 。 

基于 以 上 的 例子 ， 如 果 在 客户 端 对 交易 返回 的 哈 希 值 进行 不 断 地 监听 一 一 监听 交易 在 什么 时 
候 成 功 ， 这 将 会 存在 上 面谈 到 的 在 客户 端 进行 交易 事件 监听 的 3 个 问题 ， 所 以 是 不 可 取 的 。 

这 个 时 候 如 条 让 中 继 不 断 地 明 历 每 一 个 区 块 ， 按 照 区 块 高 度 来 逐个 遇 历 ， 当 提 币 的 交易 最 终 
在 链 上 成 功 了 ， 它 就 会 被 打包 进 一 个 区 块 中 。 目 然 地 ， 在 我 们 亿 历 到 这 个 区 块 时 ,就 能 把 里 面 的 所 
有 交易 信息 提取 出 来 ， 当 发 现 了 对 应 的 喻 希 存 在 时 ,证 明 提 币 到 账 了 。 除 此 之 外 ， 还 能 把 从 每 个 区 
块 中 通 历 出 的 交易 记录 保存 到 数据 库 中 ， 并 做 一 定 的 字段 过 沽 。 例 如 ， 只 保存 一 种 ERC20 代 币 的 
转账 记录 ， 有 了 这 些 记 录 ， 能 让 客 己 疹 发 起 交易 得 询 时 直接 租 询 以 太 坊 中 继 来 得 到 结果 ， 而 不 是 通 
过 以 太 坊 节点 的 接口 查询 。 

上 面 束 是 基于 以 太 坊 交易 的 例子 《在 交易 所 提 币 时 ) ， 是 以 太 坊 中 继 监 听 事 件 的 体现 之 一 。 
此 外 , 还 有 分 又 事件 的 监听 处 理 , 即 当 监 听 到 了 分 又 事件 时 有 可 能 会 对 茶 些 数据 更 新 进行 回 滚 操 作 

图 4-2 是 一 个 区 块 遇 有 历 的 大 致 模型 图 。 


区 块 区 块 aa “| 区 块 内 打包 了 的 


4-2 ”区 块 包含 它 所 打包 了 的 交易 


在 以 太 坊 的 机 制 中 ， 链 上 的 授权 、 交 易 、 合 约 发 布 等 事件 都 是 一 条 条 的 交易 信息 ， 我 们 把 每 
笔 交 易 信 息 提 取出 来 再 进行 分 类 应 用 ， 束 能 够 实现 不 同 的 功能 。 
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4.3 ”RPC 接口 


无 论 C/S 还 是 B/S 技术 架构 ， 客 户 端 和 服务 器 端的 交互 都 是 通过 请 求 与 啊 应 的 方式 进行 的 ， 
如 图 4-3 所 示 。 


BK ES ESwumServer 
zz pus 


图 4-3 一 般 的 客户 端 访 问 服务 器 端的 请 求 与 啊 应 


最 为 开发 者 熟悉 的 客户 闹 请 求 服 务 器 病 的 接口 就 是 “RESTful API”。 这 类 “API” 的 特点 是 ， 
客户 问 可 以 通过 使 用 “GET” 或 “POST” 的 方式 进行 请 求 。 目前 , 服务 器 新 接口 除了 “RESTful API” 
这 种 类 型 ， 还 有 一 种 就 是 我 们 多 次 提 到 的 “RPC” 接 口 类 型 。 

RPC (Remote Process Call， 远 程 过 程 调 用 ) 和 “RESTful API” 一 样 ， 能 够 被 客户 疹 应 用 于 与 
服务 器 病 的 交互 , 这 是 两 种 接口 最 大 的 共同 点 。 下面 我 们 从 协议 及 实现 的 角度 来 认识 一 下 这 两 种 接 
口 的 不 同 。 

图 4-4 所 示 是 我 们 熟知 的 OSI 七 层 网 络 通信 模型 。 


44 OSI 七 层 网 络 通 信和 模 型 


从 协议 角度 来 看 ，“RESTful API” 接 口 在 应 用 层 基于 的 协议 就 是 HTTP 或 HTTPS， 在 经 过 了 
应 用 层 到 达 传输 层 时 就 会 使 用 TCP 或 UDP 协议 。“RESTful API” 为 开发 人 员 提 供 了 多 种 请 求 方 
3X, GET/POST 请 求 方式 只 是 其 中 的 两 种 ， 还 有 Put. Delete, Head. Option 4 种 请 求 方式 。 由 于 
HTTP/HTTPS 协议 已 经 被 开发 得 很 完善 了 ， 因 此 开发 人 员 在 编写 “RESTful API” 接 口 程序 时 可 以 
大 幅 地 减少 开发 时 间 。 

“RPC” 接 口 在 基于 通信 协议 方面 的 实现 有 多 种 ， 主 要 有 下 面 的 两 种 : 

(1) E] “RESTful API” 一 样 ， 基 于 应 用 层 HTTP/HTTPS 协议 的 实现 。 

(2) 基于 传输 层 的 TCP 协议 的 实现 ， 也 被 称 为 Socket《〈 套 接 字 ) 的 实现 。 
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从 协议 的 实现 角度 来 看 ， 请 求 和 接收 响应 在 应 用 层 发 出 和 在 传输 层 发 出 有 很 大 区 别 。 如 果 是 
基于 HTTP/HTTPS 协议 实现 ， 在 速度 方面 ，“RPC” 接 口 和 “RESTful API” 接 口 几 乎 无 差别 ， 但 
基于 传输 层 的 TCP 协议 实现 “RPC” 接口 ,“RPC ?接口 除了 因为 在 数据 传输 流 经 的 层级 上 比 *RESTful 
API” 少 而 整体 比 它 快 之 外 , 传输 时 的 整体 数据 报 层 面 还 少 了 HTTP/HTTPS 的 头 部 数据 量 及 组 装 的 
时 间 损 耗 。 也 就 是 说 , 在 实现 同样 功能 的 情况 下 , “RPC” 不 仅 请 求 与 响应 速度 要 比 “RESTful API” 
快 ， 且 数据 量 也 相对 要 少 。 

此 外 ， 因 为 使 用 “TCP 协议 ”实现 的 “RPC” 接 口 不 像 应 用 层 的 HTTP/HTTPS 协议 那样 ， 已 
经 为 我 们 做 好 了 很 多 复杂 的 事情 ， 包 含 数 据 的 编码 、 解 码 等 ， 在 传输 层 上 ， 如 果 我 们 不 依赖 第 三 方 
框架 来 自己 动手 实现 一 套 “RPC” 框 架 ， 那么 从 请 求 到 响应 及 其 解码 数据 的 过 程 ， 其 难度 都 是 比较 
大 的 。 然 而 ， 由 于 现今 的 计算 机 编程 语言 都 提供 了 很 多 成 熟 的 “RPC” 框 架 ， 实 际 上 开发 者 也 可 以 
简单 地 实现 “RPC” 类 型 的 接口 。 

从 数据 传输 格式 上 进行 分 类 ， 常 见 的 “RPC” 框 架 有 以 下 几 种 : 

JSON-RPC 
XML-RPC 
Protobuf-RPC 
SOAP-RPC 


所 谓 的 “RPC” 协 议 ， 就 是 规范 了 一 种 客户 端 和 实现 了 “RPC” 接 口 的 服务 器 端 交 互 时 的 数据 
格式 。 

“RPC” 接 口 实现 的 大 致 流程 是 : 服务 的 调用 方 按照 规范 好 了 的 编码 方式 把 某 个 “RPC” 接 口 
的 函数 名 称 和 参数 进行 序列 化 编码 后 ， 发 送 到 服务 的 提供 方 ， 即 服务 器 疹 ， 服 务 器 疹 再 通过 反 厅 列 
化 后 把 对 应 的 参数 提取 出 来 ， 然 后 通过 调用 相关 函数 ， 最 后 把 结果 返回 给 服务 的 调用 方 ， 完 成 整个 


4.4 以 大 坊 接 口 


目前 以 太 坊 Go 语言 版 本 的 节点 源码 中 所 有 对 外 提供 服务 的 接口 都 是 “RPC” 类 型 的 ， 源码 地 
址 是 https://github.com/ethereum/go-ethereum.。 
为 了 方便 开发 者 学 习 使 用 , 以 太 坊 的 官方 开发 团队 采用 JavaScript 语言 开发 了 一 整套 以 太 坊 节 
点 “RPC” 接 口 的 开源 库 , 名 称 为 “web3.js” 库 , 官方 开源 地 址 是 https://github.com/ethereum/web3.js。 
除了 官方 基于 JavaScript 的 版 本 之 外 ， 我 们 到 “GitHub” 上 进行 搜索 可 以 发 现 ， 截 至 到 目前 ， 
“web3.js” 库 已 经 拓展 出 了 其 他 语言 的 版 本 ， 这 些 不 同 语言 版 本 的 web3.js 库 方 便 了 以 太 坊 相关 应 
用 的 开发 ， 如 图 4-5 所 示 。 
以 太 坊 源码 提供 的 “RPC” 接 口 有 很 多 ， 除 了 获取 余额 的 接口 “getBalance ”和 交易 的 接口 
“sendRawTransaction” 之 外 ， 还 有 估算 一 笔 交 易 的 燃料 费 接口 “estimateGas ”等 。 当 我 们 想 要 使 
用 某 个 接口 的 时 候 ， 可 以 查看 官方 的 接口 文档 ， 文 档 列举 了 所 有 “RPC” 接 口 的 信息 、 包 含 请 求 的 
参数 以 及 返回 结果 的 结构 等 。 
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官方 例子 “web3.js” 文 档 链接 是 https://web3js.readthedocs.io/en/1.0/。 
官方 “RPC” 接 口 的 完整 文档 链接 是 https://ethereum.gitbooks.io/frontier-guide/。 


3,697 repository results Sort: Best match v 


Repositories 
Code 


JavaScnpt 


ethereum/web3.js 


Ethereum JavaScript AP 


Commits 


Issues 
Javascript ap ethereum swarm 
Marketplace 
Updated 5 days ago 2 issues need help 


Topics 


Wikis 
web3j/web3j 
Users Lightweight Java and Android library for integration 


with Ethereum clients 


Languages android java reactivex njava 


Inscript Apache-2.0 license Updated 11 hours ago 12 issues need help 
HTML 


, Python 


ethereum/web3.py 


A python interface for interacting with the 


Ethereum blockchain and ecosystem. 


4-5 web3js 在 GitHub 上 的 不 同 语言 版 本 


4.4.1 重要 接口 详解 


根据 RPC 接口 文档 ， 我 们 在 开发 以 太 坊 中 继 时 主要 用 到 的 “RPC” 接 口 是 “eth” 部 分 ， 这 部 


分 的 接口 涵盖 了 区 块 和 交易 这 两 大 模块 ， 如 图 4-6 所 示 。 


2.1. Creating accounts 
2.2. Importing your presale wallet 
2.3. Listing accounts and checkin... 


2.4. Sending ether 


3.1. Introduction 
3.2. CPU mining with geth 
3.3. GPU mining 


4. Interfaces 


4.1. Command line interface and ... 
4.3. JavaScript API for Dapps 
4.4. JavaScript Console 
5. Contracts and transactions 
5.1. Account types and transactions 
5.2. Ether transfer 
5.3. Writing a contract 
5.4. Compiling a contract 


5.5. Creating and deploying a con... 


图 4-6 


JSON-RPC methods 


e Web3 clientVersion 

e web3 sha3 
net version 
net peerCount 
net listening 
eth protocolVersion 
eth syncing 
eth coinbase 
eth mining 
eth hashrate 
eth gasPrice 
eth accounts 
eth blockNumber 
eth getBalance 
eth getStorageAt 
eth getTransactionCount 
eth getBlockTransactionCountByHash 
eth getBlockTransactionCountByNumber 
eth. getUncleCountByBlockHash 
eth getUncleCountByBlockNumber 
eth getCode 
eth sign 


eth. sendTransaction 


“RPC” 接 口 完 整 文档 的 接口 函数 〈 方 法 ) 列表 
下 面 我 们 介绍 的 几 个 RPC 接口 在 开发 以 太 坊 中 继 时 都 会 用 到 ,请 务必 了 解 每 一 个 接口 的 作用 ， 
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特别 是 接口 的 函数 名 称 和 功能 。 在 讲解 接口 之 前 ， 我 们 先 介绍 3 个 重要 的 参数 : 
e genesis， 代 表 的 是 最 早 的 ， 早 期 的 源码 版 本 中 等 同 于 earliest. 
e pending， 代 表 的 是 等 待 或 挂 起 状态 中 的 。 
* latest， 代 表 的 是 最 新 完成 的 。 


这 3 个 参数 都 会 出 现在 每 一 个 接口 中 ， 关 于 它们 的 实际 使 用 ， 我 们 会 在 下 面 介绍 具体 的 接口 
时 进行 详细 说 明 。 下 面 我 们 介绍 几 个 重要 的 接口 。 
1. eth. blockNumber 


该 接口 可 以 根据 传 参 获取 3 种 类 型 的 区 块 高 度 ， 也 就 是 区 块 号 。 其 参数 包括 latest, pending. 
和 genesis。 其 中 ，“latest” 参 数 获取 的 是 当前 链 上 最 新 生成 的 区 块 的 高 度 ， “pending” 获 取 的 是 
当前 正在 被 矿工 开采 的 区 块 , 代表 正在 打包 交易 的 区 块 , 一 个 区 块 在 打包 完 一 定量 的 交易 后 才 会 完 
整 上 链 ; “genesis” 代 表 的 是 创始 区 块 的 区 块 号 ， 也 就 是 第 一 个 区 块 的 高 度 ， 要 注意 的 是 ， 最 早 的 
区 块 号 不 一 定 就 是 0， 因 为 在 生成 的 时 候 是 可 以 指定 不 为 0 的。 

2. eth getBlockByNumber 


该 接口 根据 区 块 高 度 获 取 区 块 的 部 分 信息 ， 是 在 过 历 区 块 时 主要 用 来 获取 区 块 数据 信息 的 一 
个 接口 。 它 能 够 提供 下 面 的 数据 : 


(OD 区 块头 部 的 部 分 字段 。 
(2) 所 有 打包 在 这 个 区 块 中 的 交易 的 哈 希 数组 。 


Block 区 块 的 结构 体 的 定义 如 图 4-7 所 示 。 


27 @| type Block struct { 
28 Number types.Big ` : "number" 
9 Hash common .Hash ` : "hash 

ParentHash common .Hash ` :"parentHash"" 
Nonce string ` :"nonce™ 
Sha3Uncles string ` :"sha3Uncles™ 
LogsBloom string ` ;"logsBloom"^ 
TransactionsRoot string ` :"transactionsRoot"^ 
ReceiptsRoot string ` :"stateRoot™ 
Miner string ` : "miner" 
Difficulty types.Big ` : "difficulty" 
TotalDifficulty types.Big ` :"totalDifficulty" 
ExtraData string ` :"extraData™ 
Size types.Big ` :"Size"" 
GasLimit types.Big ` :"gasLimit"^ 
GasUsed types.Big ` :"gasUsed"" 
Timestamp types.Big ` : "timestamp 


Uncles []string ` :"uncles™ 


/ fz rfr ~ H T Vv ZI 
JURI A hash KA 


Transactions []string 


4-7 以 太 坊 Go 版 本 源码 中 Block 区 块 结构 体 的 定义 
3. eth getTransactionByHash 
该 接口 可 根据 一 笔 交 易 记 录 的 哈 布 值 获取 这 笔 交 易 的 详细 信息 。 该 接口 提供 了 交易 查询 功能 ， 
在 获取 区 块 信息 后 ， 从 区 块 信息 中 获取 被 打包 的 交易 的 哈 希 值 ， 进 行 全 部 交易 记录 信息 的 提取 。 处 
于 pending (SFREE) 状态 的 交易 ， 返 回 的 将 会 是 空 ， 我 们 也 可 以 根据 接口 的 这 个 特点 来 判断 
一 笔 交 易 是 否 成 功 ， 它 能 够 给 我 们 提供 如 图 4-8 所 示 的 数据 。 
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type Transaction struct ( 
Hash string ` json: "hash" 
Nonce types.Big `j : "nonce 
BlockHash string `j :"blockHash"` 
BlockNumber types.Big `j : "blockNumber "` 
TransactionIndex types.Big `j :"transactionIndex"^ 
From string `j : "from" 
To string ` json: "to" 


Value types.Big 'json:"value'"" 
GasPrice types.Big 'json:"gasPrice'"' 
Gas types.Big `j :"gas™ 
Input string ` json: "input" 

string vt 

string 

string 


4-8 以 太 坊 Go 版 本 源码 中 Transaction 交易 结构 体 的 定义 
图 4-8 交易 数据 中 各 个 字段 的 含义 是 : 
Hash, Hoi 
Nonce， 当 前 交易 对 应 的 系列 号 。 
BlockHash， 当 前 交易 被 打包 进 区 块 的 哈 布 值 。 
BlockNumber, ioci) 包 进 区 块 的 高 度 ， 也 就 是 区 块 号 。 
TransactionIndex， 当 前 交易 在 区 块 的 所 有 打包 了 的 交易 数组 中 的 下 标 。 
From， 发 起 交易 的 以 太 坊 地 址 。 
To， 这 笔 交 易 发 往 的 以 太 坊 地 址 。 注 意 ， 这 里 不 能 直接 看 作 是 收 款 人 的 以 太 坊 地 址 。 在 合约 
类 代 币 交易 中 ， 就 是 智能 合约 的 以 太 坊 地 址 。 
Value， 这 笔 交 易 的 交易 额 ， 对 应 的 是 以 太 坊 ETH 的 数量 。 如 果 是 合约 类 代 币 交易 ， 这 个 数 
值 应 该 是 0。 
GasPrice， 这 笔 交 易 每 笔 燃料 (Gas) 的 价格 ， 详 情 参 考 “ 交 易 参 数 的 说 明 ” 一 节 。 
Gas， 对 应 的 就 是 “GasLimit”， 详 情 参 考 “ 交 易 参 数 的 说 明 ” 一 节 。 
Input， 就 是 “交易 参数 的 说 明 ” 一 节 中 所 讲 的 “data”。 
R、S、V， 和 交易 签名 相关 的 3 个 字段 ， 是 验 签 时 所 需要 的 字段 。 


m 


eth_getTransactionReceipt 


该 接口 可 根据 一 个 交易 的 哈 硕 值 来 获取 这 笔 交 易 收 据 的 详情 。 注 意 ， 该 接口 返回 的 数据 在 一 

定 程度 上 和 eth getTransactionByHash 是 相同 的 ， 但 该 接口 返回 的 数据 更 详细 ， 例 如 交易 的 日 志 

“Logs”, 这 也 是 我 们 进行 事件 监听 最 主要 的 数据 源 。 和 eth_getTransactionByHash 一样 ,处 于 pending 
状态 的 交易 ， 返 回 的 将 会 是 空 。 该 接口 能 提供 如 图 4-9 所 示 的 数据 。 


type TransactionReceilpt struct ( 


BlockHash 
BlockNumber 
ContractAddress 


CumulativeGasUsed 


From 

GasUsed 

Logs 

LogsBloom 

Root 

Status 

To 
TransactionHash 
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string 


types.Big `j 


string 


types.Big ` 


string 


types.Big `j 


[]Log 


string 
string 
*types.Big `j 
string 
string 
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:"blockHash"' 
:"blockNumber"" 
:"contractAddress"' 
:"cumulativeGasUsed"" 
:"from™ 
:"gasUsed"" 
;"logs'" 
:"logsBloom" 
;"root'"" 

:"status'" 

: to” 
:"transactionHash"' 


:"transactionIndex"' 


TransactionIndex types.Big `j 


4-9 ”以 太 坊 Go 版 本 源码 中 TransactionReceipt 收据 结构 体 的 定义 
除去 与 eth getTransactionByHash 相同 的 数据 字段 外 ， 该 接口 其 他 数据 字段 的 合 义 如 下 : 


e CumulativeGasUsed， 该 字段 和 GasUsed 不 一 样 ， 目 前 还 没有 一 个 通俗 的 解释 ， 包 含 官 方 文档 
对 它 的 描述 也 不 清晰 。 它 所 代表 的 是 当前 交易 所 在 区 块 的 交易 列表 中 ， 当 前 TransactionIndex 
之 上 包含 自身 的 其 他 所 有 交易 的 GasUsed 之 和 。 例 如 ，TransactionIndex=5， 那 么 它 的 
CumulativeGasUsed 数值 为 下 标 是 0、1、2、3、4、5 的 交易 的 GasUsed 数值 之 和 . 

€ ContractAddress， 合 约 地 址 ， 这 个 字段 只 有 在 当前 交易 是 合约 创建 的 情况 才 会 有 值 ， 对 应 的 

是 新 创建 合约 的 以 太 坊 地 址 ， 其 他 情况 都 是 空 。 

GasUsed， 实 际 消耗 的 燃料 费 ， 它 和 GasLimit 的 关系 请 参考 

n i 由 当前 交易 生成 的 事件 (Event) 日 志 。 

Root， 当 前 交易 在 默 克 尔 树 根 节点 的 哈 布 值 。 

Status， 如 果 这 笔 交 易 最 终 是 成 功 的 ， 那 么 其 值 为 rue， 也 就 是 1， 否 则 为 false。 


“交易 参数 的 说 明 ” 一 节 。 


5. eth getBalance 

这 个 接口 获取 的 是 某 个 以 太 坊 地 址 的 ETH 数值 ， 即 ETH 余额 。 注 意 ， 它 不 是 获取 ERC20 fX 
币 及 其 他 代 币 的 余额 。 

6. eth sendTransaction 和 eth sendRawTransaction 

这 两 个 接口 在 “以 太 坊 交易 ”一 节 中 己 经 做 过 介绍 ， 是 所 有 交易 的 触发 接口 。 其 中 ， 
eth sendRawTransaction 可 以 完成 的 交易 类 型 包含 eth sendTransaction 的 类 型 。 


7. eth getTransactionCount 


该 接口 可 根据 一 个 以 太 坊 钱包 地 址 获取 基于 当前 钱包 地 址 的 交易 序列 号 Nonce。 该 接口 传 入 的 
第 二 个 参数 就 是 “genesis” 各 参数 分 别 对 应 下 面 的 作用 : 


(1) 取 genesis 时 ， 获 取 当 前 以 太 坊 地 址 第 一 次 发 起 交易 时 的 Nonce 序列 号 。 
(2) HX pending 时 ， 获 取 当 前 以 太 坊 地 址 提交 了 的 且 正 处 于 pending 状态 等 待 被 区 块 打 包 的 
prd iui Nonce 序列 号 。 请 注意 ， 如 果 当 前 查询 的 地 址 没有 处 于 pending 状态 的 交易 ， 那 
么 它 将 返回 与 latest 一 样 的 Nonce 号 。 
(3) 取 latest 时 , 获取 当前 以 太 坊 地 址 提交 了 且 被 区 块 成 功 打 包 了 的 交易 订单 所 对 应 的 Nonce 
序列 号 加 一 的 值 。 举 个 例子 ， 地 址 A 最 后 一 笔 成 功 交 易 对 应 的 Nonce 为 4， 当 调用 接口 传 入 该 参 


“pending” 和 “latest”， 
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数 的 时 候 ， 获 取 的 结果 就 是 5。 
(4) 在 eth getTransactionCount 中 ，Nonce 查询 满足 : pending = latest = genesis. 


8. eth. getCode 

该 接口 根据 以 太 坊 地 址 判断 当前 地 址 是 非 合 约 地 址 还 是 合约 地 址 。 如 果 是 非 合 约 地 址 ， 那 么 
返回 值 是 “0x”; 如 果 是 合约 地 址 ， 那 么 返回 值 则 是 智能 合约 当初 创建 时 的 十 六 进 制 码 。 

9. eth estimateGas 


该 接口 用 来 估算 一 笔 交 易 要 消耗 多 少 GasLimit, 注意 所 估算 出 的 值 没有 涉及 GasPrice。 入 参 中 
的 “data” 是 被 估算 的 数据 量 ， 估 算 的 结果 数值 和 数据 量 成 正比 。 这 个 接口 在 钱包 发 起 交易 时 让 用 
户 选择 燃料 费 为 多 少 的 功能 上 会 用 到 , 体现 在 燃料 费 进 度 条 中 的 最 大 值 上 。 最 大 值 一 般 就 是 这 个 接 
口 返回 的 数值 。 

10. eth call 

这 是 以 太 坊 用 来 访问 智能 合约 函数 的 万 能 “RPC” 接 口 , 意思 是 任何 智能 合约 上 的 公有 函数 都 
能 使 用 这 个 接口 进行 访问 。 前 面 提 到 ，“eth getBalance ”是 用 来 查询 以 太 坊 ETH 余额 的 ， 如 果 要 
查询 非 ETH 的 代 币 余额 ， 例 如 ERC20 代 币 的 余额 ， 就 可 以 通过 eth. call 来 进行 查询 。 这 个 接口 的 
入 参 和 “sendTransaction / sendRawTransaction ”接口 是 一 样 的 。 

在 eth call 中 ,我 们 可 以 通过 控制 data 参数 值 中 的 “methodId” 及 所 调用 的 合约 的 入 参 来 达到 
访问 不 同 智能 合约 函数 的 目的 。 

此 外 ， 请 务必 了 解 ，eth_call 接口 是 内 读 的 ， 它 不 会 造成 区 块 链 上 数据 的 改变 ， 上 自然 也 就 不 会 
造成 真实 数据 的 改变 ,以 ERC20 代 币 转 账 为 例 ,一 般 转 账 用 sendRawTransaction, 是 否 可 以 用 eth call 
来 实现 转账 呢 ? 因为 eth call 接口 的 定义 是 ， 可 以 访问 智能 合约 中 的 所 有 函数 ， 既 然 transfer 是 智 
能 合约 中 的 一 个 函数 ， 那 么 eth call 就 能 访问 该 图 数 ， 而 且 sendRawTransaction 转账 到 EVM 虚拟 
机 执行 data 时 也 会 用 到 合约 中 的 transfer KZ, 所 以 是 否 可 以 用 eth. call 实现 转账 , 答案 是 否定 的 。 

这 里 我 们 对 eth. call. 只 读 特 性 从 源码 层面 做 一 下 说 明 。 

以 太 坊 虚拟 机 EVM 在 执行 合约 代码 时 会 先 使 用 区 块 号 blockNumber 找 出 对 应 的 区 块 信息 , 再 
系统 地 根据 这 个 区 块 的 数据 实例 化 一 个 名 为 status 的 变量 ， 由 status 来 实例 化 对 应 的 虚拟 机 EVM 
实例 , 然后 根据 区 块 提供 的 信息 来 实例 化 合约 代码 中 的 变量 值 ， 即 智能 合约 的 函数 被 执行 前 它 的 变 
量 值 是 由 当前 的 区 块 高 度 来 决定 的 。 如 此 一 来 ，eth_call 在 调用 transfer 函数 时 会 直接 在 代码 的 内 存 
层面 进行 值 的 修改 ， 而 并 没有 广播 出 去 和 修改 到 数据 库 层 面 。 

下 面 我 们 继续 借助 一 个 例子 中 进行 进一步 的 直观 认识 。 

请 看 下 面 的 例子 : 

block 为 1000 时 ， 余 额 值 为 10， 然 后 使 用 eth. call 在 1000 高 度 转账 了 1 MRM, eth call 会 根 
据 1000 高 度 的 状态 实例 化 EVM， 余 额 为 10; 待 EVM 执行 eth_call 的 data 后 ， 此 时 在 内 存 层面 余 
额 变 为 9， 当 前 的 EVM 实例 在 执行 完 eth. call 后 释放 ， 不 会 被 广播 ; 等 调用 eth. call W balanceOf 
时 ，eth_call 会 再 实例 化 一 个 1000 高 度 状态 下 的 EVM， 人 余额 为 10。 此 时 再 用 sendRawTransaction 
转账 1 个 代 币 ， 这 笔 交 易 被 广播 ， 假 设 被 打包 进 了 1001 区 块 高 度 。 此 时 调用 eth_call， 将 实例 化 出 
来 一 个 1001 高 度 状态 下 的 EVM，balanceOf 读 取 余额 为 9。 
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44.2 证 点 链接 


要 想 访 问 以 太 坊 节点 的 接口 ， 震 要 知道 接口 的 链接 。 这 和 第 规 的 服务 器 疹 开 发 ， 获 取 服 务 器 
端的 “IP” 和 疹 口 “Port” 是 一 样 的 。 目 前 获取 节点 链接 的 方案 主要 有 以 下 两 种 : 
e 自行 购买 服务 器 ， 然 后 启动 以 太 坊 节点 服务 程序 ， 例 如 “Geth”， 再 获取 节点 程序 提供 的 接 
口 链接 。 
e 使 用 第 三 方 服务 平台 提供 的 节点 链接 。 


对 于 第 一 种 方法 ， 操 作 流 程 是 先 下 载 对 应 的 以 太 坊 节点 版 本 源码 ， 然 后 根据 文档 的 编译 方法 
进行 目 编 详 ， 生 成 可 执行 程序 ， 再 部 赣 到 服务 器 亲 。 需 要 注意 的 是 ， 以 太 坊 节点 的 源码 不 仅仅 有 版 
本 号 不 同 的 版 本 ， 还 有 不 同 计 算 机 语言 的 版 本 ， 官 方 的 “Geth” 是 “Golang” 语 言 开 发 的 版 本 ， 源 
人 链接 是 https;//github.com/ethereum/go-ethereum. 

第 一 种 方案 整体 实施 起 来 有 以 下 优 缺点 : 

(D 可 目 定义 性 高 。 
可 以 自行 配置 节点 局 动 的 配置 文件 。 
可 自行 修改 源码 进行 二 次 开发 后 再 编译 。 
可 自行 设置 服务 网 关 、 节 点 集群 等 相关 的 运行 方式 。 
可 参与 公 链 挖 矿 ， 赚 取 以 太 坊 ETH 的 收入 。 
(2) 技术 要 求 难 度 相 对 来 说 比较 高 。 
o 要求 使 用 者 必须 掌握 和 了 解 配置 文件 中 各 项 属性 的 含义 及 其 影响 。 
o 要求 使 用 者 必须 懂 一 定 的 服务 器 端 运 维 的 知识 。 
o 要 求 使 用 者 懂得 对 应 节点 编写 语言 的 编译 命令 ， 甚 至 使 用 过 该 门 语言 。 
(3) 自 运 维 成 本 高 。 
e ”要求 监控 节点 服务 器 的 运行 情况 。 
o 要 求实 现 节点 程序 ， 因 为 某 些 问题 被 杀 死 后 能 够 进行 自重 局 。 
o 在 集群 情况 下 ， 要 求 保证 各 服务 的 稳定 性 。 


(4) 需要 目 付 费 服务 器 等 产品 的 花 销 。 

第 二 种 方案 在 学 习 阶 段 以 及 线 上 业务 不 需要 高 度 目 定义 化 的 情况 下 使 用 。 相 比 第 一 种 方案 而 
言 ， 第 二 种 方案 的 优 缺 点 刚好 和 第 一 种 方案 相反 。 除 此 之 外 ， 第 二 种 方案 也 是 最 方便 的 ， 因 为 只 下 
要 一 个 链接 即 可 。 

以 下 的 所 有 内 容 我 们 主要 基于 第 二 种 方案 进行 讲解 ， 以 及 如 何 获取 免费 的 节点 链接 。 


4.4.3 ”获取 链接 


我 们 可 以 从 网 站 https://infura.io/ 来 免费 获取 节点 链接 。Infura 是 国外 一 个 托管 以 太 坊 节点 的 集 
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群 ， 从 国内 访问 暂时 不 用 翻 墙 ， 且 还 允许 开发 者 免费 申请 属于 目 己 的 以 太 坊 节点 链接 (包含 以 太 坊 
主 网 和 测试 网 络 )， 可 以 说 十 分 方便 和 齐全 ! 

打开 Infura 的 主页 后 ， 单 击 “GET START FOR FREE” 按 钮 就 能 进行 链接 的 申请 ， 如 图 4-10 
所 示 。 


^ © 6 https//infura.io 


图 4-10 Infura 的 创建 账号 入 口 按 钮 
单 击 进行 申请 后 ， 首 先 完成 账号 的 注册 ， 如 图 4-11 所 示 。 


4-11 Infura 的 账号 注册 页 面 


填写 好 资料 后 ， 单 击 “SIGN UP”， 此 时 Infura 会 发 送 一 封 验证 邮件 到 你 的 邮箱 ， 登 录 你 的 邮 
箱 查 看 这 封 邮件 ， 在 邮件 内 单 击 “CONFIRM EMAIL ADDRESS” 链 接 ， 进 行 外 部 链接 的 访问 ， 即 
可 完成 注册 ， 如 图 4-12 所 示 。 

待 成 功 进 入 控制 台 页 面 ， 需 要 先 创建 一 个 项 目 ， 以 方便 管理 。 根 据 提示 ， 我 们 创建 一 个 名 为 
“test” 的 项 目 ， 如 图 4-13 所 示 。 
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Thank you for signing up 


You're signed up for the most powerful and scalable blockchain 
infrastructure. Please confirm your email address to continue setup. If 
you received this by mistake or weren't expecting it, please disregard 
this email. 


Infura wants to make sure we're addressing your needs. Check out our 


documentation, and don't hestitate to contact support. 
单 击 这 个 按钮 完成 注册 


CONFIRM EMAIL ADDRESS 


4-12  Infura 注册 账号 时 发 送 的 验证 邮件 


YOUR PROJECTS 


OQ Mola Bet en deos H 


Get started by creating your first project 
Setup your project to generate AP! keys, endpoints, 
and whitelist contracts. 


43 创建 好 账号 后 创建 新 项 目 
输入 项 目 名 称 后 的 效果 如 图 4-14 所 示 。 


ADD NEW PROJECT 


CREATE PROJECT CANCEL 


4-14 设置 项 目的 名 称 


得 入 名 称 后 按 下 回 车 键 ， 创 建成 功 后 ， 束 可 以 在 控制 台 页 面 看 到 分 配给 我 们 的 以 太 坊 节点 网 
HR BERS o JE RERE DIFI“ ENDPOINT” F RIBER P, 可 以 看 到 完整 的 节点 链接 , 其 中 按钮 " MAINNET" 
这 个 节点 链接 的 是 主 网 “main” 就 是 主要 的 意思 ， 同 时 用 鼠标 左 键 单 击 这 个 按钮 ， 就 能 看 到 下 拉 
列表 的 网 络 类 型 选择 ， 每 种 网 络 类 型 对 应 有 亨 点 链接 ， 如 图 4-15 Hrs. 
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EP: https://mainnet.infura.io/v3/2e6d9331f74d472a9d47fe99f697ca2b。 
“ROPSTEN” 测 试 网 络 : https://ropsten.infura.io/v3/2e6d9331f74d472a9d47fe99f697ca2b。 


YOUR PROJECTS CREATE NEW PROJECT 


© TEST 


API KEY 


2e549331f74d472a9d 


APT SECRET @ 单 击 之 以 切换 © 
3cc080d82349a4df8ab.. ^ / 网 络 类 型 


Whitelist Your Contracts @ 


图 4-15 创建 好 项 目 后 获取 不 同类 型 的 节点 链接 
节点 的 分 类 ( 见 图 4-16) : 


(1) MAINNET， 代 表 的 是 以 太 坊 主 网 ， 如 果 我 们 使 用 这 个 链接 来 测试 ， 那 么 所 有 的 资产 转 
换 都 是 真实 的 资产 。 对 应 的 区 块 链 浏览 右 链 接 是 https://etherscan.io/。 

(2) ROPSTEN， 代 表 的 是 以 太 坊 的 测试 网 络 ， 使 用 的 共识 算法 是 “PoW”， 意 味 着 可 以 采 
用 挖 矿 来 获取 测试 的 ETH。 如 果 使 用 这 个 链接 来 测试 ， 那 么 资产 都 是 测试 的 ， 这 些 测 试 的 资产 可 
以 通过 控 矿 或 申请 获得 。 对 应 的 区 块 链 浏览 器 链接 是 https://ropsten.etherscan.io/。 

(3) KOVAN 和 PINKEBY 一 样 ， 也 是 以 太 坊 的 测试 网 络 ， 但 是 使 用 的 共识 算法 是 “PoA” 
(Proof-of-Authority， 权 威 证 明 ) ，“PoA” 是 由 硅 干 个 权威 节点 来 生成 区 块 ， 其 他 节点 则 无 权 生 
成 ， 目 然 地 也 就 不 能 使 用 挖 矿 的 形式 获取 ETH 测试 币 ， 只 能 够 通过 申请 获得 。 它 们 对 应 的 区 块 链 
浏览 器 链接 分 别 是 : 

https://kovan.etherscan.10/ 


https://rinkeby.etherscan.io/ 


API KEY 


2e6d9331f74d47229d. E 


API SECRET O 


3cc00d82349a4dfBab. | 


Whitelist Your Contra 
ENDPOINT MAINNET v 


Search and whitelist the sp 
mainnet.infur ROPSTEN smart contracts that yo 


application uses. 


KOVAN 
RINKEBY 


图 4-16 获取 不 同类 型 的 节点 
4.4.4 ”进行 测试 


在 上 面 的 一 节 中 ， 我 们 获取 了 以 太 坊 的 节点 链接 ， 现 在 我 们 来 进行 一 下 简单 的 测试 ， 看 看 是 
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侣 可 以 真 的 对 节点 进行 访问 。 

首先 选择 使 用 主 网 的 链接 进行 简单 的 测试 ， 把 链接 从 Infura 的 管理 台 页 面 复制 下 来 ， 在 链接 
前 面 加 上 “https”。 这 点 不 要 漏 了 ， 目 前 Infura 提供 的 节点 链接 都 是 基于 “https ”协议 的 ， 地 址 如 
下 : 

https://mainnet.infura.io/v3/2e6d933 1 f74d472a9d47fe99f697ca2b 

然后 打开 “PostMan” 工 具 ， 如 果 没 有 安装 “PostMan”， 也 可 以 在 网 上 找 一 个 在 线 的 模拟 请 
求 工 具 网 页 进行 测试 。 在 “PostMan” 中 ， 选 好 “Post” 的 请 求 形 式 并 粘贴 好 节点 链接 。 这 里 ， 你 
可 能 会 有 一 个 疑问 ， 为 什么 直接 使 用 “Post” 这 个 “RESTful API” 的 请 求 方式 来 进行 测试 ， 不 是 
应 该 使 用 “RPC” 吗 ? 

原因 是 以 太 坊 的 源码 中 提供 了 可 以 选择 是 否 开 局“Http” 服 务 选项 的 功能 ， 而 Infura 的 节点 都 
是 开启 了 的 ， 所 以 我 们 可 以 方便 地 使 用 “RESTful API” 的 形式 进行 访问 ， 如 图 4-17 所 示 。 


(t infura.io/v3/2e6093311744472a9d47fe991697ca2l 


Body 


(1 ~ i 
H- E pt ia 
——— H riu j ^r 
form-data X-WwwWw-form-uriencoded binary 
1 N S 
V Z 


Post 参数 的 格式 


4-17 使 用 PostMan 工具 测试 mfura 提供 的 节点 链接 


再 到 区 块 链 浏览 器 “https:Wetherscan.io/” 中 随便 找 一 笔 交 易 ， 复 制 它 的 哈 希 值 ， 准 备 到 
“PostMan” 中 使 用 以 太 坊 的 “eth getTransactionByHash” 查 询 这 笔 交 易 的 详情 ， 如 图 4-18 所 示 。 
0x7be00cb83d7a3bda70fb8bd06142e6bb121bcdf2f665839d9a65671f£5cacb098 


Transaction Details Earn Interest 、 
Etherscan - Sponsored slots available. Book your slot here! 

Overview Event Logs (1) State Changes | New | Comments 

Status Q Success 

Block: 6614660 1156171 Block Confirmations 

Timestamp: © 197 days 9 hrs ago (Oct-31-2018 01:12:45 AM +UTC) 

From 0x5b3d576c8e828bd51470150847b106032eba98e?5 (D 


To: Contract 0x78021abd9b06f0456cb9db95a845c302c34f8b8d © (D 


Tokens Transferred » From 0x5b3d576c668... To 0x37f06ad5050... For 10,000 ($1.46) E5 ERC-20 (CDCC) 


图 4-18 查询 交易 详情 


146 | 区 块 链 以 太 坊 DApp 开发 实战 


回 到 “PostMan” 中 ， 进 行 请 求 参 数 的 组 装 。 按 照 “Json-RPC” 的 参数 格式 ， 组 装 好 如 下 的 参 
数 〈 人 参考 图 4-19) : 


{ 
"ISOHFpoUS 2. Dm 
"method": "eth getTransactionByHash", 
"params": [ 


"0x7be00cb83d7a3bda70fb8bd06142e6bb121bcdf2f665839d9a65671f£5cacb098" 
l]; 
aia 23 


https://mainnet.infura.io/v3/2e6d9331f74d472a9d47fe99f697ca2b 


(1) Body e Pre-request Script 


form-data x-www-form-urlencoded — * raw binary JSON (application/json) 


Bi 

"jsonrpc": "2.0", 

"method": "eth getTransactionByHash", 

"params": 
"Ox7be80cb83d7a3bda70fb8bd06142e6bb121bcdf2f665839d9a65671f5cacb098" 


"VJ OY ut 5 Uu MN IE 
4 


图 4-19 组 装 好 请 求 参数 
然后 单 击 “Send” 按 钮 ， 即 可 进行 访问 ， 如 图 4-20 所 示 。 


Params Send v 


4-20 Fit; PostMan 工具 中 的 发 送 网 络 请 求 按钮 


可 以 看 到 结果 返回 了 我 们 要 查询 的 交易 的 详细 信息 。 由 于 返回 的 数据 是 十 六 进 制 格式 的 字符 
串 ， 稍 做 转化 后 再 和 上 面 区 块 链 浏览 器 https:VWetherscan.io/ 中 的 数据 进行 对 比 ， 就 会 发 现 数据 是 一 
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根据 交易 hash 得 询 交易 返回 的 数据 


4-2] PostMan 工具 在 请 求 后 显示 返回 的 交易 数据 


4.4.5 ”获取 测试 币 


上 面 一 节 我 们 进行 的 是 主 网 上 的 非 转 账 类 测试 ， 如 果 要 进行 转账 ， 就 会 产生 真实 的 公 链 上 的 
资产 园 移 。 因 此 一 般 资产 方面 的 开发 测试 都 是 在 测试 网 络 中 进行 的 , 测试 网 络 有 目 行 搭建 的 测试 节 
点 网 络 和 现在 大 型 公用 的 ROPSTEN、KOVAN 和 PINKEBY 测试 网 络 。 下 面 我 们 以 ROPSTEN 为 
例 来 测试 获取 以 太 坊 ETH 代 币 。 

首先 打开 “水 龙头 ”网 站 https://faucet.ropsten.be/. Ropsten 测试 以 太 坊 ETH 代 币 主要 是 从 这 
个 网 站 进行 申请 ,进入 主页 后 , 直接 在 输入 框 中 输入 要 接收 测试 币 的 以 太 坊 钱包 地 址 , 再 单 击 “Send 
me test Ether” 按 钮 即 可 ， 如 图 4-22 所 示 。 


Ropsten Ethereum Faucet 


Enter your testnet account address 


N 


输入 以 太 坊 钱包 地 址 ， 单 击 下 血 的 按钮 就 可 以 获取 代 币 了 


4-2 在 水 龙头 网 站 获取 测试 币 


在 按钮 下 面 显 示 出 了 交易 的 哈 硕 值 ， 证 明 已 经 给 我 们 的 地 址 发 送 了 测试 的 以 太 币 ， 如 图 4-23 
所 示 。 目 前 在 水 龙头 网 站 中 每 个 地 址 每 天 只 能 领取 一 次 测试 以 太 币 ， 如 果 想 在 短 时 间 内 获取 多 个 ， 
可 以 使 用 多 个 钱包 地 址 来 领取 ， 然 后 在 测试 网 络 中 通过 以 太 坊 转账 交易 来 汇总 。 
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Ropsten Ethereum Faucet 


Enter Your testnet account address 


0x27d2ecd2e14e52243b68fcf2321f7a9550bdc0f2 


Send me test Ether 


Test ETH sent to 0x27d2ecd2e14e52243b68fcf2321f7a9550bdc0f2. 


图 4-23 ”显示 交易 的 哈 希 值 


领取 了 测试 以 太 币 ， 我 们 到 Ropsten 测试 网 络 的 区 块 链 浏览 器 网 页 中 输入 地 址 “0x27D2ECD 
2E14e52243b68FcF2321f7a9550bdc0f2”， 对 以 太 坊 ETH 余额 查询 进行 验证 。 此 外 ， 其 他 测试 网 络 


产生 的 交易 信息 也 都 可 以 到 网 页 中 进行 查询， 链接 为 https://ropsten.etherscan.io/address/0x27d2ecd 
2e14e52243b68fcf2321f7a9550bdc0f2， 如 图 4-24 所 示 。 


e Etherscan 


All Filters ~ Search by Address 
M * —3 -f> 
Ropsten Testnet 47 测试 网 络 的 标志 
Network 


Home Blockchain * Tokens 


ai Address 0x27D2ECD2E14e52243b68FcF2321f7a9550bdcOf2 © 


Overview 


Balance. 1.5902675388 Ether 


测试 网 络 的 以 太 坊 代 币 More Info 


My Name Tag: Not Available 


Token: $0.00 E] 


Transactions Erc20 Token Txns 


IF Latest 16 txns 


4-24 ”在 区 块 链 浏览 器 查看 获取 了 的 测试 币 


45 ”项 目 准备 


在 对 中 继 有 了 整体 的 认识 并 获取 了 节点 链接 的 相关 准备 信息 后 ， 我 们 开始 介绍 “以 太 坊 中 继 ” 
代码 编写 的 项 目 准 备 。 


本 项 目 将 会 基于 下 面 的 环境 及 编辑 器 : 
(1) 使 用 “Golang” 开 发 语言 。 
(2) 编译 环境 是 “go1.9.2”， 也 可 以 选择 更 高 版 本 。 
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(3) 开发 工具 是 “Goland” 。 


“Go” 编 译 环境 在 电脑 上 的 配置 ， 这 里 不 做 过 多 说 明 。 对 于 不 同 操作 系统 的 电脑 ， 读 者 可 以 
到 网 上 搜索 相关 的 教程 。 例 如 ，“Windows 64” 系 统 可 以 参考 下 面 的 链接 : 

https://blog.csdn.net/kwame211/article/details/79094695 

开发 工具 “Goland” 的 下 载 地 址 是 https:/www.jetbrains.com/go/?fromMenu。 打 开 链 接 后 ， 单 
击 “DOWNLOAD” 按 钮 进行 下 载 ， 如 图 4-25 Bron. 


https //www jetbrains.com/go/?IromMenr 


Coming in 2018.3 What's New Features Lear 


DOWNLOAD 


图 4-25 Goland 开发 工具 的 下 载 页 面 
下 载 好 之 后 ， 按 照 利 规 的 软件 安装 流程 进行 安 逆 。 在 欢迎 页 面 直 接 单 击 “Next” 按 钮 。 在 软 
件 的 安装 路 径 页 面 中 ， 也 可 以 直接 采取 默认 设置 ， 单 击 “Next” 按 钮 ， 按 以 下 流程 操作 即 可 ， 如 图 
4-26 所 示 。 


Choose Install Location 
Choose the folder in which to install GoLand. 


Setup will install GoLand in the following folder. To install in a different folder, click 
Browse and select another folder. Click Next to continue. 


Welcome to GoLand Setup 


Setup will guide you through the installabon of GoLand. 


It is recommended that you close all other applications 
before starting Setup. This will make it possible to update 
relevant system files without having to reboot your 
computer, 


Jc TE Coe I a 


Click Next to continue. 


Destination Folder 
[C:\Program Files\JetBrains\GoLand 2018.2.3 | | Browse... 


Space required: 552.7 MB 
Space available: 124.5 GB 


4-26 安装 Goland 的 流程 
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- €? GoLand Setup 
= GoLand Setup 
Choose Start Menu Folder 
Installation Options Choose a Start Menu folder for the GoLand shortcuts. 
Configure your GoLand installation 


Select the Start Menu folder in which you would like to create the program's shortcuts. 
You can also enter a name to create a new folder. 


Me 义 上 ， 让 它 在 桌面 显示 — 
[32-bit launcher | [~] 64-bit launch kx | 
uncher] |^ it launcher 快 键 方 式 


2144 游 戏 中 心 
360 实 全 中 心 


[ ].go 


Administrative Tools 
Geth 


Git 

GitHub, Inc 

Go Programming Language 

JetBrai | d» - €& » ME 
iain HERI; "Install" fZHl 


开始 安装 


E GoLand Setup 


Completing GoL and Setup 


GoLand has been installed on your computer. 


Click Finish to close Setup. 


£y Complete Installation 
dr rim. ds Án pam 
r h ig JH" | - | A 
dn X A 2x HIERHER A I J] Import GoLand settings from: 
© Previous version (C:\Users\Administrator\. GoLand2017. 3Xconfig) 


OQ Custom location. Config folder or installation home of the previous version: 


图 4-26 GE) 
选择 了 “Donot import settings” 后 ， 直 接 单 击 “OK ”按钮 。 在 看 到 的 界面 用 鼠标 清 动 到 最 下 
面 ， 再 单 击 “Accept” 按 钮 。 在 最 后 的 激活 页 面 ， 目 前 网 上 也 有 一 些 可 用 的 激活 码 ， 如 果 没 找到 可 
用 的 ， 可 先 选 择 “30 天 免费 ”使 用 ， 最 后 单 击 “Evaluate” 按 钮 进行 激活 ， 如 图 4-27 所 示 。 
贪 GoLand License Activation 


© Activate 


Evaluation is free for 30 days. NS 


选择 30 天 免费 


Buy GoLand 


[]Send me tips to learn GoLand faster 


DTell me about new product features as they come out 


| Email address : 


g to these newsletters, vou agree to tł 


开局 
N 


[| = 


4-27 选择 30 天 免费 的 界面 
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4.6 创建 项 目 


接 下 来 开始 创建 以 太 坊 中 继 项 目 。 首 先进 入 到 我 们 配置 “Go ” 编 详 环境 的 环境 变量 “GOPATH ” 
所 在 的 文件 夹 ， 例 如 电脑 的 路 径 是 “Di\go_1.9\go_path”， 就 进入 到 “go_path” 文 件 夹 ， 如 图 4-28 
Bras 


v |go path 


主页 — 共享 AA 


~ 个 > 此 电脑 > DATA (D:) > go 1.9 > go path 


»*^ 名 称 修改 日 期 类 型 


2018/11/17 10:10 XL 


4-28 创建 Go 编译 环境 的 GOPATH 变量 所 指向 的 文件 夹 


在 文件 中 创建 一 个 名 称 为 “src” 的 文件 夹 ， 用 来 作为 后 续 项 目的 源 代 码 目 录 OCTEX . 
“src” 文 件 夹 将 会 作为 一 个 我 们 所 有 “go” 项 目的 父 级 文件 夹 。 现 在 我 们 进入 到 “src” 文 件 
夹 中 ， 创 建 “ 以 太 坊 中 继 ” 项 目 “eth-relay”， 如 图 4-29 所 示 。 


修改 日 期 


d jJ» (1.2 > l 》 》 
VR XE 
eth-relay 2018/11/17 10:14 HFH 


4-29 在 go path 下 创建 项 目 


现在 我 们 回 到 安装 好 的 “Goland” 开 发 工具 中 ， 在 执行 完了 “4.4 项 目 准 备 ” 一 节 的 最 后 一 个 
步骤 后 ，“Goland” 会 自动 打开 主页 面 。 

在 主页 面 中 ， 先 单 击 左上 角 的 “File” 菜 单项 ， 再 单 击 “Open” 荣 单 选 项 ， 意 图 是 打开 一 个 项 
日 ， 在 单 击 “Open” 之 后 所 弹出 的 选择 框 中 找到 我 们 刚刚 创建 的 “eth-relay” 项 目 ， 然 后 打开 它 ， 
如 图 4-30 所 示 。 
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Open... 

Open URL... 
Open Recent 
Close Project 


Rename Project... 


P Settings... Ctrl+Alt+S 
Settings for New Projects.… 


Import Settings... 


Š Open File or Project x 
â EOR kx S G Hide path 


Digo moopamseemem | — l 


v Mgo 1.9 
> Mapi 
D bin 
D blog 
Bu doc 
= go path 
v Msrc 


4-30 在 Goland 中 打开 创建 好 了 的 项 目 
打开 后 如 果 看 到 的 是 如 图 4-31 所 示 的 页 面 ， 就 说 明 打开 成 功 了 。 


sth-relay ID:\go ! 9\go Pahvzcveth-eg 门 -CsLonGfAdminizrtrasol 
File Edit View Navigate Code Refactor Run Iools VCS Window Help 
S HS - - ljAdiCofgwaion. | > 5 G E J^ " 
E eth-relay | 

WiPo»O- 9 -— 

Ba eth-relay Doo 1 9o p 
> Illy External Libraries 
> "gScratches and Consoles 


4-31 Goland 中 打开 创建 好 了 的 项 目 


接 下 来 ， 在 “Goland” 中 设置 “go” 的 环境 变量 。 首 先 还 是 单 击 左上 角 的 “File” 沫 单项， 然 
后 单 击 “Settings ”菜单 选项 ， 进 入 到 设置 页 面 后 再 单 击 列表 栏 中 的 第 一 项 “Go”， 进 入 到 “Go” 
相关 设置 的 页 面 ， 如 图 4-32 所 示 。 


Vendoring & Build Tags 
Imports 
Dep 
Go Module (vgo) 
Project Structure 
> Appearance & Behavior 
Keymap 
> Editor 
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Go 


Suggest parameters name in completion 


[ ] Indent on enter in raw strings 
[C] Show documentation in parameter info 


Detect go packages from clipboard 


When directory is renamed 
O Show options 
(€) Rename package 


© Do not rename package 


When package is renamed 
(€) Show options 


( Rename directory 


4-32 在 Goland 中 设置 GOROOT 或 GOPATH 环境 变量 


单 击 图 4-32 中 的 “GOROOT” 选 项， 进行“GOROOT” 的 设置 同 理 ， 对 “GOPATH” 选 项 


进行 相关 的 设置 ， 本 例 保持 不 变 即 可 。 


为 什么 在 一 开始 的 时 候 下 载 安 装 并 设置 好 了 “Go” 的 编译 环境 后 ， 在 这 里 又 要 进行 一 次 设置 
呢 ? 这 是 因为 在 “Goland” 开 发 工具 中 设置 的 环境 变量 ， 其 优先 级 别 是 最 高 的 ， 如 果 不 进 行 设置 ， 
就 会 使 用 安装 时 的 默认 设置 ， 这 并 不 适合 我 们 的 要 求 。 

单 击 “GOROOT” 选 项， 可 以 看 到 此 时 “Goland” 已 经 默认 帮 我 们 选择 好 了 当初 安装 时 设置 


的 路 径 ， 如 图 4-33 所 示 。 


如 果 发 现 “GOROOT” 还 没有 对 应 任何 “Go” 版 本 的 路 径 ， 


们 手动 选择 添加 ， 如 图 4-34 所 示 。 


GOROOT 

GOPATH 

Vendoring & Build Tags 
Imports 

Dep 

Go Module (vgo) 


Project Structure 


或 者 想 进 行 日 定义 修改 ， 击 要 我 


Go >? GOROOT For current proje 


Go ) GOROOT For current proj 


8 Go 1.9.2 (D^go 1.9) 


GOPATH 
Vendoring & Build Tags 
Imports 
Dep 
Go Module (vgo) 
Project Structure 
> Appearance & Behavior 
Keymap 
> Editor 
Plugins 
» Version Control 


4-34 


O 
YV YY YY Ww yY vy vyv vy 2 
Im 一 
uo 


É 5olsct Home Directory for Co SDE 


h mx 


cygwin 
DTLFolder 

egth 
GameDownload 
Genymotion 

Git 

go 

go 19 


手动 设置 GOROOT 环境 变量 文件 夹 
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同样 地 ，“GOPATH” 选 项 也 可 以 通过 在 “Goland” 中 得 看 当前 “GOPATH” 环 境 变量 的 文 
件 夹 来 进行 设置 ， 即 可 以 在 图 4-35 中 进行 有 关 设 置 。 
Qy For current project 


v Go * Global GOPATH 


GOROOCT DAgo 1.9Ygo path 


GOPATH 


Vendoring & Build Tags 
Imports 
Dep 
Go Module (vgo) 
Project Structure 
> Appearance & Behavior 
Keymap 


4-35 “手动 设置 GOPATH 环境 变量 


4.7 第 一 个 Go 程序 


在 “GOTOOT” 和 “GOPATH ”环境 变量 都 设置 好 之 后 ， 就 可 以 进行 项 目的 代码 编号 了 。 退 
出 所 有 的 设置 界面 ， 回 到 我 们 刚刚 打开 了 的 “eth-relay” 项 目的 主页 面 中 。 

首先 ， 将 鼠标 移动 到 界面 中 的 项 目 名 称 处 ， 用 鼠标 右 击 选择 “New” 一 “GoFile”， 创 建 一 个 
新 的 “Go” 文 件 ， 取 名 为 “main.go”， 如 图 4-36 所 示 。 


eth-relay [DAgo 1.9Xgo pathisrcheth-relay] - GoLand (Administrator) 
Elle Edit View Navigate Code Refactor Run Iools VCS Window Help 
>| 8 GoFile 
Ctrl+X | & File 
Ctrl+C tnis Cmd script 
Copy Path Ctrl+Shift+C | Æ Scratch File — Ctrl«Alt 
= > lilli External U Copy Relative Path Ctrl+Alt+Shift+C Directory 
> "gScratches| Ê Paste Ctrl+V | & HTML File 
Find Usages Alt+F7 Stylesheet 
Find in Path... Ctrl Shift«F | asa JavaScript File 
Replace in Path... Ctrl+Shift+R | asa TypeScript File 


Inspect Code... 1) tsconfig json File 


y (8 package .json File 


4-36 在 项 目 文件 夹 下 创建 一 个 Go 的 代码 文件 


可 以 看 到 “eth-relay” 项 目 文件 夹 下 多 出 了 一 个 “main.go ”文件 。“.go” 后 级 结尾 的 就 是 “go” 
语言 的 标准 源 代 码 文件 , 用 鼠标 双击 文件 就 能 在 编辑 器 的 右边 区 域 进行 代码 编辑 ， 如 图 4-37 所 示 。 

接 下 来 我 们 先 编写 好 下 和 面 的 一 段 测试 代码 ， 尝 试 编译 一 下 ， 如 图 4-38 所 示 。 代 人 码 运 行 后 将 会 
在 “Goland” 自 带 的 控制 台中 输出 “hello ETH” 和 字符 串 。 先 在 “main.go” 文 件 中 将 第 一 行 的 “package 
eth_relay” 改 为 “package main”， 表 示 这 个 “main.go” 文 件 将 是 我 们 整个 程序 局 动 时 的 入 口 文 件 ， 
而 后 再 输入 人 代码。 其中， 代码 中 出 现 的 “/** 内 容 */” 代 表 的 是 注释 部 分 ， 可 以 将 其 删除 。 
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File Edit View reisen Ex SES Run oos VCS Window Help 
€-HHo e Add Configuration... ^5 Ta 
eth-relay = main.go 
Po. © > X 
v Meth-relay Di\g 1.9\go package eth relay 
* main.go é 


> Jilli External Libraries 4 /FZ(huthor): HAE / jt 
aa o n . ? (1 19 / 了 了 
> “ø Scratches and Consoles 3 "E LE ated on : 2018/11/1; 
F " 


ile Edit View wow en tede Run ook VCS Window Help 
*€-Huuo e Add Configuration... P 
eth-relay == main.go 
Pro» © => 多 一 WW maingo 
eth-relay D\go 190 p : package main 
让 main.go 
> lilli External Libraries 


> “Scratches and Consoles 
ti func main() { 
fmt.Println( a: "hello ETH") 


import "fmt" 


HEU. SERE Heil EUT 


5 4-38 "ili main 函数 左边 的 三 角形 按钮 即 可 编译 并 运行 程序 


package main 

import "fmt" 

func main() { 
fmt.Println("hello ETH") 


TE "Goland" F, SAUAZHSBETIHRIJSA, pi ERREF H "import "fmt" " SUA 
要 我 们 手动 输入 。 单 击 绿 色 的 三 角形 按钮 ， 在 弹出 的 框 中 单 击 第 一 栏 “run go build main.go” 就 能 
对 整个 程序 进行 编译 并 运行 。 运 行 的 结果 将 会 在 控制 台中 输出 ， 如 图 4-39 所 示 。 


= go build main.go 


«4 go setup calls» 
hello ETH 


Process finished with exit code 0 


a iS 6: TODO 
到 4-39 ”编译 并 运行 程序 后 ， 在 控制 台 输出 的 内 容 
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4.8 ERE “RPO” yum 


t P ARR A m P Pro AI HOK e) mA, IUEHZETERULTREDGBRK DUKE T ks DIETE DE 
WORKA, "ERAN INGIZOSE INE ex, WE 4-40 所 示 。 


Request Client 
请 求 者 1 
Request Client 
请 求 者 2 
Request Client 
请 求 者 3 


图 4-40 不 同 节 点 链接 对 应 的 请 求 客户 端 

表面 谈 到 ， 我 们 访问 以 太 坊 节点 的 接口 都 是 “RPC” 接 口 类 型 ， 这 就 要 求 我 们 的 客户 疹 属 于 
“RPC” 客 户 端 ， 首 先 新 建 一 个 名 为 “ETH RPC Client.go” 文 件 ， 如 图 4-41 所 示 。 

在 接 下 来 的 过 程 中 ，“RPC” 客 户 端 内 部 将 会 用 到 以 太 坊 源码 中 的 一 个 “RPC” 依 赖 库 。 为 什 
么 使 用 以 太 坊 的 依赖 库 ? 这 个 并 不 是 强制 要 求 的 , 也 可 以 使 用 其 他 的 依赖 库 。 建议 读者 在 实际 开发 
中 使 用 到 各 种 功能 库 时 ， 如 果 能 从 以 太 坊 go 版 本 源码 获取 ， 就 尽量 不 要 去 引用 其 他 的 库 ， 或 者 目 
己 进 行 库 的 编写 。 

下 面 我 们 来 介绍 依赖 库 的 下 载 和 使 用 。 


i eth-relay [DAgo 19Ngo patPsrcyeth-relay] - -VETH RPC Clientgo [eth-relay] - GoLand (Administrator! 


File Edit View Navigate Code Refactor Run Tools VCS Window Help 


go build main. go v| > 4i ^ " 


扣 mino < 


= eth-relay  * ETH_RPC Client.go 
Proy © > X 一 局 maingo > | ETH RPC Client.go 


package main 


v Pweth-relay D\go 1.9go p 1 


8 ETH RPC Clientgo| ， /*2 
4 IEH (Author): WEZE / AE FHER 


* main.go 
> |l External Libraries 
> "gy Scratches and Consoles : 


5 Created on : 2018/11/18 


4-41 创建 以 太 坊 RPC 客户 端 代码 文件 


4.8.1 下 载 依赖 库 


以 太 坊 go 版 本 源码 自 带 的 依赖 库 在 “GitHub” 上 ， 是 开源 的 ， 读 者 需要 的 话 ， 就 可 以 自己 下 
载 。 可 以 使 用 “Go” 编 译 环境 自 带 的 命令 下 载 到 “go path” 文 件 夹 中 ， 下 载 好 之 后 ， 就 可 以 直接 


进行 使 用 了 ， 命 令 是 : 
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go get xxxx 

其 中 ，xxxx 代表 远程 依赖 库 在 “GitHub” 中 的 路 径 ， 以 太 坊 go 版 本 源码 的 路 径 是 
github.comy/ethereumygo-ethereum。 在 “Goland” 撒 部 的 控制 台 “Terminal” 中 输入 下 面 的 命令 ， 按 
回 车 键 ， 执 行 命令 就 可 以 进行 下 载 了 ， 如 图 4-42 Pr. 


go get github.com/ethereum/go-ethereum 


Terminal 


十 Microsoft Windows [RÆ 10.0.17134.407] 
(c) 2018 Microsoft Corporation。 保 留 所 有 权利 。 


D:Xgo 1.9Xgo pathNMsrcNeth-relayxgo get github.com/ethereum/go-ethereum 


Æ 2: Favorites 


aa 7; Structure 


> 4: Run := 6: TODO 
4-2 在 Goland 命令 行 控制 台 输 入 命令 


下 载 过 程 中 ， 需 要 等 待 一 段 时 间 ， 时 间 的 长 度 取决 于 网 速 等 因素 ， 依 赖 库 下 载 好 之 后 ， 在 控 
制 台 能 够 看 到 的 现象 是 ， 命 令 行 的 “开始 输入 行 ”为 起 了 一 行 ， 且 没有 错误 信息 输出 。 如 图 4-43 
Bra. 


Terminal 


Microsoft Windows [版 本 10.0.17134.407] 
(c) 2018 Microsoft Corporation. $% H Pr A BL. 


D:\go 1.9Xgo path\src\eth-relay>go get github.com/ethereum/go-ethereum 


D:Mgo 1.9\go path\src\eth-relay> 


图 443” 按 回 车 键 运 行 命令 结束 后 控制 台 的 显示 


也 可 以 到 “go path” 文 件 夹 下 验证 查看 ， 如 果 “go-ethereum” 依 赖 库 已 经 成 功 被 下 载 下 来 ， 
那么 它 将 会 存放 于 “github.com ”文件 夹 中 的 “ethereum” 中 ， 如 图 4-44 所 示 。 


| go-ethereum 


A 人 名称 


共享 TUE 
* DATA (D:) > go 1.9 > go path f src > github.com > ethereum > go-ethereum > 
h wi 18 丫 4 


git 2018/11/18 11:42 
.github 18/11/18 11:42 
accounts 2018/11/18 11:42 
build 2018/11/18 11:42 
cmd 2018/11/18 11:42 
common 2018/11/18 11:42 
consensus < /11/18 11:42 
console 2018/11/18 11:42 
containers 2018/11/18 11:42 
contracts 2018/11/18 11:42 
18/11/18 11:42 
crypto 2018/11/18 11:42 
dashboard 2018/11/18 11:42 WE 
eth 2018/11/18 11:42 eHe 


4-44 通过 Go 的 Get 命令 下 载 好 了 的 且 存 放 在 GOPATH 文件 夹 下 的 以 太 坊 源码 
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依赖 库 下 载 成 功 后 ， 下 面 我 们 来 定义 并 实现 “RPC” 客 户 端 。 
4.82 编写“RPC” 客 户 端 


在 新 建 的 “ETH RPC _ Client.go” 文 件 中 输入 下 面 的 代码 。 


type ETHRPCClient struct { 
NodeUrl string // 代表 节点 的 url 链接 
client *rpc.Client // 代表 rpe 客户 端 句柄 实例 
} 


// NewETHRPCClient 代表 的 是 新 建 一 个 “RPC” 客户 端 
// 入 参 nodeUrl 就 是 节点 的 链接 ， 返 回 的 是 带 有 * HJ ETHRPCClient 对 象 指针 
func NewETHRPCClient (nodeUr] string) *ETHRPCClient { 

// & 符号 代表 的 是 取 指 针 


return &ETHRPCClient( 

NodeUrl:nodeUrl, 
] 

在 输入 了 上 面 的 代码 后 ， 会 发 现在 “client *rpc.Client” 行 中 “rpc” 显 示 的 是 红色 字体 ， 代 
表 这 里 有 和 错误。 此 时 ， 用 鼠标 单 击 一 下 编辑 框 内 的 一 个 区 域 ， 束 能 看 到 “Goland” 给 予 我 们 的 错 谋 
提示 ， 如 图 4-45 所 示 。 这 个 提示 的 意思 是 : 依赖 库 rpc 的 名 称 有 重复 ， 需 要 手动 选择 导入 ， 无 法 
目 动 识别 进行 包 的 导入 。 

提示 语 中 有 一 个 “Alt+Enter” 组 合 键 文字 ， 在 提示 框 还 没有 消失 的 时 候 ， 按 下 这 个 组 合 键 ， 
就 能 进入 到 选择 库 的 弹 框 中， 在 选择 库 的 阐 框 里面 可 以 手动 进行 库 的 选择 ， 如 图 4-46 所 示 。 共 有 
两 个 “RPC” 库 。 第 一 个 是 “net/rpc”， 代 表 “Go” 环 境 安 装 时 日 融 的 系统 网 络 库 ; 第 二 个 是 
“go-ethereum ”， 也 就 是 我 们 前 面 所 下 载 的 以 太 坊 go 版 本 节点 源码 中 的 依赖 库 。 理 所 当然 ， 我 们 
要 选择 第 二 个 。 


func NewFTHRPCClient(nodeUrl string) *ETHRPCClient ( 
return &ETHRPCClienti( 


NodeUr1l:nodeUrl, 
} 
} 


4 


4-45  Goland 提示 可 以 通过 组 合 键 Alt+Enter 把 依赖 包 导 入 到 代码 中 
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type ETHRPCClient struct { 
NodeUrl string 
client "*rpc.Client 
} Package to import 
net/rpc 
github.com/ethereum/go-ethereum/rpc 


1i 
ance d 


在 第 -个 弹 框 显示 时 ， 按 下 ALT+Enter 组 合 键 ， 
进入 到 选择 库 的 弹 杠 中 ， 此 时 按键 盘 的 上 下 键 
或 用 鼠标 单 击 就 能 选择 相应 的 库 


func NewETHRPCClient(nq 
return &ETHRPCClie 


图 4-46 多 个 同名 的 依赖 包 ， 需 要 选择 导入 哪 一 个 
手动 选择 好 了 依赖 库 后 ， 可 以 看 到 代码 中 多 出 了 导入 包 的 一 行 ， 如 图 4-47 所 示 。 


S maingo - $39 ETH RPC Client.go 
package main 


import ( 


"n 
"github.com/ethereum/go-ethereum/rpc" 


type ETHRPCClient struct ( 
NodeUrl string 
client *rpc.Client 


) 


) 


ETHRPCCLien 


j ' nodeUrl. j , "a 
func NewETHRPCClient(nodeUrl string) *ETHRPCClient ( 


e j E+ 
return &ETHRPCClient( 
NodeUr1l:nodeUrl, 
) 
) 


图 4-47 导入 依赖 包 后 代码 文件 显示 出 对 应 的 路 径 


接 下 来 我 们 实现 初始 化 “*rpc.Client ”句柄 实例 , 请 将 必要 的 函数 补充 到 “ETH_RPC Client.go" 
中 。 到 了 这 一 步 ， 我 们 的 “RPC” 客 户 端的 封装 差不多 就 完成 了 。 代 码 如 下 : 
// 初始 化 rpc 客户 端 句柄 实例 


func (erc *ETHRPCClient) initRpc() 1 

// 使 用 go-ethereum 库 中 的 rpc 库 来 初始 化 

// DialHTTP 的 意思 是 使 用 nttp 版 本 的 rpc 实现 方式 

rpcClient,err := rpc.DialHTTP(erc.NodeUrl) 

if err !- nil ( 
// 初始 化 失败 ， 终 结 程序 ， 并 将 错误 信息 显示 到 控制 台中 
errInfo := fmt.Errorf(" 初 始 化 rpc client 失败 %s",err.Error()) .Error () 
panic (errInfo) 


) 
// 初始 化 成 功 ， 将 新 实例 化 的 rpc 句柄 赋值 给 ETHRPCClient 结构 体 里 面 的 client 


erc.client = rpcClient 


对 于 “initRpc()” 初 始 化 函数 ， 将 会 在 “RPC” 客 户 端 创建 函数 时 进行 调用 ， 也 就 是 在 
“NewETHRPCClient” 子 数 内 部 进行 调用 ， 这 里 我 们 先 修改 “NewETHRPCClient” 了 函数 为 下 和 面 的 
样子 。 
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func NewETHRPCClient(nodeUrl string) *ETHRPCClient { 
//| & 符号 代表 的 是 取 指 针 
client := &ETHRPCClient( 
NodeUrl:nodeUrl, 
} 
client.initRpc() // 进行 初始 化 rpc 客户 端 句 柄 实例 


return client 


最 后 ， 还 要 补充 一 个 “GetRpc” 妙 数 ， 以 便 让 “ETHRPCClient” 结 构 体 里 和 面 的 rpe 请 求 句柄 
实例 “client” 能 够 被 外 部 引用 。 


// Go 语言 语法 中 ， 大 写字 母 开 头 的 变量 或 者 函数 〈 方 法 ) 才能 够 被 外 部 引用 
// 小 写字 母 的 变量 或 函数 (方法 ) 只 能 内 部 调用 
// GetRpc 函数 (方法 ) 是 为 了 方便 外 部 能 够 获取 client *rpc.client， 以 便 进行 访问 
func (erc *ETHRPCClient) GetRpc() *rpc.Client { 
if erc.client == nil { 
erc.initRpc () 
} 


return erc.client 


完整 的 代码 如 图 4-48 所 示 。 


& main.go 5 ETH RFC Client.go 


package main 
import ( 
"fmt" 


"github.com/ethereum/go-ethereum/rpc" 


) 


type ETHRPCClient struct { 
NodeUrl string '/ IER 
client *rpc.Client // fi rpc 
} 


/ THRDC iont d j ppr» 
/ NewETHRPCCLient [ur "RPC 


// A38 nodeUrL. £4 5, j£ + SJ ETHRPCCI 
func NewETHRPCClient(nodeUrl string) *ETHRPCClient { 
// & Fi 


client := &ETHRPCClient( 
NodeUr1:nodeUr1, 
} 


client.initRpc() // 
return client 


} 


func (erc *ETHRPCClient) initRpc() ( 
// 1 go-ethereum HJ rpc K ey Sit 


// DiaLHTTP RH A 7 http KARI rpc € 
rpcClient,err := rpc.DialHTTP(erc.NodeUr1) 
if err !- nil { 


errInfo := fmt.Errorf( format: "初始 化 rpc client "WO s",err.Error()).Error() 
panic(errInfo) 


// 4 KIH, LAN rpc i Ni ETHRPCCLient 
erc.client = rpcClient 


// GetRpc P2 / cLient *rpc.CLient 
func (erc *ETHRPCClient) GetRpc() *rpc.cClient ( 
if erc.client -- nil { 
erc.initRpc() 
) 
return erc.client 


) 


图 4-48 ”完整 的 代码 
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4.8.3 ”单元 测试 


单元 测试 在 软件 编写 的 过 程 中 是 必 不 可 少 的 ， 因 此 在 我 们 所 要 实现 的 “以 太 坊 中 继 ” 中 也 需 
要 对 东 些 功能 代码 进行 单元 测试 。 

我 们 先 对 “RPC” 客 户 端的 初始 化 函数 进行 一 轮 简 单 的 单元 测试 ， 这 里 使 用 的 是 “Go” 语 言 
目 斋 的 单元 测试 模块 。 

首先 在 项 目 中 新 建 一 个 名 称 为 “ethrpc testgo” 的 文件 “Go” 的 单元 测试 模块 规定 了 属于 单 
元 测试 “go” 编 译文 件 的 名 称 须 符合 后 级 是 “ testgo”， 例 如 “nihao testgo”， 如 图 4-49 所 示 。 


*kH o e TestNewETHRPCClient in eth-relay x > i$ € 


eth-relay — : ethrpc test.go 
Project ~ ix 一 Ü maingo x | 9 ETH RPC Client.go 
5 eth-relay D\go 1 9\go path\sn ? 9 package main 
; & ETH RPC Client.go i | 


5» ethrpc test.go 


9 main.go 


> lil External Libraries 


> “o Scratches and Consoles 


449 创建 Go 的 单元 测试 代码 文件 
单元 测试 文件 入 口 函数 的 定义 规则 是 ， 以 大 与 的 “Test” 单 词 开头 。 当 然 ，“Goland” 对 于 在 
单元 测试 文件 内 打出 的 字母 “test” 也 会 给 予 提 示 ， 如 图 4-50 所 示 。 在 提示 出 现时 直接 按 回 车 键 就 
能 目 动 补充 为 完整 的 单元 测试 函数 。 


* main.go *  * ETH RPC Clientgo x  "ethrpc test.go 
» package main 


te st| 
test Tes. 
Ctrl+ 向 下 箭头 and Ctrl+ 向 上 箭头 will move caret down and up in the editor >> 


i main.go x  * ETH RPC Clientgo x  "»ethrpc test.go 
package main 


import "testing" 


func TestName(t *testing.T) ( 
} 


单 击 这 个 入 按 钮 就 能 运行 每 个 单元 测试 也 数 


默认 的 测试 晃 数 名 称 ， 可 以 自行 修改 


4-50 Goland 的 代码 提示 与 目 动 补 全 
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图 4-50 中 有 两 点 比较 重要 : 第 一 点 是 每 个 日 动 补 全 的 单元 测试 函数 都 是 默认 的 “TestName”， 
这 里 需要 我 们 上 自行 进行 名 称 的 修改 ; 第 二 点 是 , 每 个 单元 测试 函数 的 左边 都 会 显示 一 个 绿色 的 和信 按 
钮 ， 单 击 这 个 按钮 即 可 运行 当前 的 图 数 。 

紧 接 着 我 们 把 “TestName” 修改 为 “TestrNewETHRPCClient”， 这 样 修改 的 意思 是 为 了 测试 
“NewETHRPCClient” 这 个 图 数 ， 再 输入 如 下 的 代码 : 


func TestNewETHRPCClient(t *testing.T) { 
// 首先 是 一 个 格式 正确 的 链接 测试 初始 化 
client2 := NewETHRPCClient ("www.nihao.com").GetRpc() 
if client2 == nil { 
fmt .Println ("初始 化 失败 ") 
} 
// 接着 是 123://456 非法 链接 测试 初始 化 
client := NewETHRPCClient ("123://456") .GetRpc() 
if client == nil { 
fmt .Println ("初始 化 失败 ") 
} 


LUI GSERATPITSER. 最 后 单 击 “Goland” 顶 部 工具 栏 的 绿色 人 和信 按 钮 进行 编译 及 
运行 ， 观 察 控 制 台 中 的 运行 结果 。 

运行 结果 如 图 4-51 a. 可 以 看 到 ， 在 解析 链接 “123:/456” 的 时 候 出 现 了 错误 ， 表 明 这 不 
是 一 个 合法 的 链接 。 由 于 是 初始 化 阶段 的 错误 ， 因 此 我 们 直接 采用 “panic” 的 方式 让 程序 衣 溃 ， 
此 时 的 错误 相当 于 致命 错误 。 如 果 不 想 让 程序 崩 尝 ， 可 以 在 “ETH _RPC Client.go ”文件 中 将 
“panic(errInfo)” 一 行 代码 修改 为 别 的 内 容 。 


^. TestNewETHRPCClient in eth-relay 
» @ Tests failed: 1 of 1 test - 16 ms 


Hund «4 go setup calls» 


panic: 初始 化 rpc client 失败 parse 123://456: first path segment in URL cannot contain colon [recovered] 
goroutine 18 [runninz]: ———— 
testing.tRunner.funcli(0xc0e421020f0) 

D:/go 1.9/src/testing/testing.go:711 +0x2d9 
panic(0x6f62a0, 0xc0412044d20) 

D:/go 1.9/src/runtime/panic.go:491 40x291 
eth-relay.(*ETHRPCClient).initRpc(0xc8420de7a0) 

D:/go 1.9/go patn/src/eth-relay/ETH RPC Client.go:32 40x174 
eth-relay.NewETHRPCClient(0x76cO0b5, 0x9, 0xc0420de760) 

D:/go 1.9/go pat^/src/cth-rclay/ETH RPC Clicnt.go:20 (0x62 
eth-relay.TestNewETH3PCClient(0xc04212320f0) 

D:/go 1.9/go path/src/eth-relay/ethrpc test.go:15 *0x76 
testing.tRunner(0xc0421020f0, 0x780f83) 

D:/go 1.9/src/testing/testing.go:746 +Bxd7 
created by testing.(*T).Run 

D:/go 1.9/src/testing/testing.go:789 40x2e5 


Process finished with exit code 2 


图 4-51 控制 台 在 代码 运行 错误 时 的 红色 提示 信息 


4.9” 编 与 访问 接口 代码 


接 下 来 开始 使 用 我 们 前 面 封 装 好 的 “RPC” 客 户 问 来 对 以 太 坊 节点 的 “RPC” 接 口 进 行 访 问 。 
接口 在 名 称 上 的 分 类 主要 有 两 种 : 一 种 是 参数 不 需要 用 到 “data” 了 字段 的 ， 男 一 种 是 需要 用 到 


第 4 章 实现 以 太 坊 中 继 一 一 基础 接口 | 163 


“data” 了 字段 的 。 例 如 ， 获 取 ERC20 代 币 的 余额 ， 就 需要 设置 好 调用 “eth_call” 函 数 〈 方 法 ) 的 
“data ”参数 字段 ， 而 “eth getTransaction ”获取 交易 信息 则 不 需要 传递 “data” 参 数 。 


4.9.1 ”认识 “Call” 函 数 


标准 的 “RPC” 客 户 端 都 应 该 具备 发 出 请 求 函数 的 功能 ， 由 于 我 们 所 使 用 的 “RPC” 依 赖 库 基 
于 以 太 坊 “Go” 版 本 源码 ， 因 此 自然 地 依赖 库 就 具备 了 请 求 函 数 。 

在 “Goland” 中 ， 对 于 在 “Go” 源 人 码 文件 中 所 引入 的 依赖 库 文件 ， 可 直接 通过 按 住 Ctrl 键 再 
单 击 鼠 标 左 键 ， 即 可 进入 到 对 应 源码 文件 中 查看 其 中 的 函数 。 

现在 我 们 进入 “ETH RPC_Client.go” 源 码 文 件 所 引用 的 “RPC” 库 文件 中 ， 按 住 Ctrl 键 再 用 
鼠标 左 键 单 击 源码 文件 下 面 一 行 代码 最 后 边 的 “rpc” 单 词 。 


"github.com/ethereum/go-ethereum/rpc" 


可 以 看 到 ， 在 编辑 器 的 主页 面 中 显示 出 了 “rc” 依 赖 包 下 的 源码 文件 文件 夹 ， 其 中 有 一 个 
"clientgo" X fF, nl 4-52 所 示 。 


£x — = maingo - 8 ETH RPC Clientgo 
ethstats 4 " fmt " 


event 5 "github. con/ethereun/go-ethereul/rpc"] 


internal ) 


les 8 type ETHRPCClient struct ( 
light 9 NodeUrl string // 
1€ client *rpc.Client /, 
log ) 
metrics 12 
miner 13 H NewETHRPCCLi 
à ; / AZ ML. 2 uM rar p j 
mobile f 
ho NewETHRPCCHientnedeurl irri ETHRPCC 
// 
cient :=  &ETHRPCClient( 
NodeUrl:nodeUnrl, 


> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 


} 
client.initRpc() // 
return client 


9» client example test.go 


wr 


4-52 在 Goland 的 代码 文件 中 单 击 导入 后 的 依赖 包 名 称 可 以 看 到 对 应 的 源码 文件 夹 


用 女 标 双击 “client.go” 文 件 ， 在 打开 的 文件 中 可 以 看 到 每 个 函数 的 注释 ， 如 图 4-53 Bron. 


src —— githubcom . — ethereum | Wl go-ethereu | D rpc > 9 dlient.go | 
你 — X maingo- 9 ETH RPC Client.go 


[ go-ethereum Librar 
inder the terms of the GNU 


the implied 


out even 
or FITNESS FOR A PARTICULAR PURPOSE 
ral Pi l ] 


package rpc 


import ... 


4-53. 在 打开 的 源码 文件 夹 中 双击 源码 文件 来 查看 源码 的 内 容 
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通过 查看 “client.go” 源 人 码 文件 ， 发 现 其 中 有 一 个 名 称 为 “Call” 的 函数 (如 图 4-54 所 示 ) ， 
该 函数 允许 调用 者 发 起 “RPC” 请 求 ， 这 正 是 我 们 要 找 的 函数 。 这 个 函数 非 第 重要 ， 可 以 说 我 们 所 
要 实现 的 绝 大 部 分 的 以 太 坊 “RPC” 接 口 请 求 函 数 都 会 依赖 “Call” 图 数 来 达到 目的 。 下 面 逐 个 解 
析 该 函数 所 传 入 的 参数 含义 。 
238 // CaLL performs a JSON-RPC call with the given arguments and unmarshals into 

// result if no error occurred. 

// 

// The result must be a pointer so that package json can unmarshal into it. You 

// can aLso pass nil, in which case the result is ignored. 


func (c *Client) Call(result interface(), method string, args ...interface()) error ( 
Ctx ;= context.Background() 
return c.CallContext(ctx, result, method, args...) 


} 
4-54 client.go 源码 文件 中 的 Call 函数 代码 
“Call” KZN F: 


func (c *Client) Call (result interface{}, method string, args ...interface{}) error 
( 

Ctx :- context.Background() 

return c.CallContext(ctx, result, method, args...) 


第 一 个 参数 “result” 的 数据 类 型 是 “Go” 语言 中 的 “interface{} ”类 型 ， 它 类 似 Java 语言 中 
的 泛 型 ， 可 以 代表 任何 类 型 ， 作 用 是 接收 存储 “RPC” 请 求 后 得 到 的 结果 值 。 

第 二 个 参数 “method” 的 数据 类 型 是 “string” 了 字符 串 类 型 ， 作 用 是 用 来 标明 请 求 的 接口 名 称 ， 
例如 获取 交易 记录 的 “eth getTransactionByHash” 就 是 “method” 一 个 可 能 的 取 值 。 

第 三 个 参数 “args ”的 数据 类 型 是 “Go” 的 多 泛 型 参数 “...interface{1”， 表 示 可 以 传 入 一 个 
参数 或 者 两 个 、 三 个 参数 等 ， 且 每 个 参数 都 是 一 个 “interface{}” 泛 型 ， 既 可 以 是 int64 整数 类 型 ， 
也 可 以 是 string 字符 串 类 型 。 


4.9.2 ”查找 请 求 的 参数 


在 项 目 中 新 建 一 个 名 称 为 “ETH RPC Requester.go” 的 文件 ， 代 表 使 用 “RPC” 客 户 端的 请 
求 者 ， 此 后 所 要 进行 封装 的 、 访 问 以 太 坊 接口 的 函数 都 将 写 在 这 个 文件 中 。 

以 下 编写 根据 以 太 坊 交易 哈 希 值 来 获取 交易 信息 的 接口 函数 ， 作 为 示例 来 介绍 接口 函数 的 实 
现 方法 。 

首先 编写 下 面 的 代码 ， 进 行 “RPC” 请 求 者 实例 化 的 定义 及 其 函数 的 初始 化 。 因 为 每 个 请 求 者 
都 需要 拥有 一 个 客户 端 成 员 ， 一 一 对 应 ， 请 求 者 从 自身 绑 定 的 “RPC” 客 户 端 发 出 请 求 ， 所 以 请 求 
者 “ETHRPCRequester” 内 部 拥有 一 个 客户 新 指针 类 型 的 变量 “client *ETHRPCClient”。 


type ETHRPCRequester struct { 


client *ETHRPCClient // 小 写字 母 开头 ， 私 有 的 rpe 客户 端 
} 


func NewETHRPCRequester(nodeUrl string) *ETHRPCRequester { 
requester := &ETHRPCRequesterí] 
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// 实例 化 rpc 客户 端 


requester.client = NewETHRPCClient (nodeUrl) 
return requester 


代码 如 图 4-55 所 示 。 


eth-relay — * ETH RPC Requester.go 

Project» © > £x — WE maingo * | 9 ETH RPC Client.go > 
eth-relay D'\go 1.9\go path 1 package main 

5 ETH RPC Client.go - 


= ETH RPC Requester.go 


S ethrpc test.go : } 


type ETHRPCRequester struct { 
client *ETHRPCClient // b3 TF EIX 


= main.go func NewETHRPCRequester(nodeUrl string) *ETHRPCRequester ( 


> Jilli External Libraries requester :- &ETHRPCRequester() 


> "ø Scratches and Consoles // KAE rpe Eri 
requester.client = NewETHRPCClient(nodeUrl) 


return requester 


4-55 ETH RPC Requester.go 代码 


Be PREM RDE A." ORR RIS BU SOLE) 9m "Call" RAASTA, IKR 
交易 信息 ”接口 函数 的 3 KEA, 73 82 E SCHU U; IR HU ULUK E; “RPC” ORAS, A 
可 以 根据 下 面 的 两 种 方式 得 知 : 


(OD 查看 官方 文档 ， 相 关 信 息 在 “以 太 坊 接口 ”一 市 中 已 经 介绍 过 。 
(2) 碍 看 本 书 曾 列举 并 介绍 过 的 接口 。 


在 “获取 交易 信息 ”接口 国 数 中 ， 得 看 官方 “RPC ”接口 文档 ， 其 链接 是 
https://ethereum.gitbooks.io/frontier-guide/。 打 开 文 档 后 ， 可 以 看 到 以 太 坊 所 有 相关 的 介绍 都 完全 上 
备 。 在 主页 中 找到 第 4 小 节 中 的 “JSON RPC API”， 单 击 即 可 ， 如 图 4-56 所 示 。 


2.1. Creating accounts 


JSON-RPC methods 


2.2. Importing your presale wallet 
web3 clientVersion 
2.3. Listing accounts and checkin. . . = 
e web3 sha3 
2.4. Sending ether — 
e nci versn 
e net peerCount 
e net listening 
3.1. Introduction EE J 
。 eth protocolVersion 


3.2. CPU mining with geth » eth. syncing 


3.3. GPU mining e eth coinbase 


z 。 eth mining 
4. Interfaces z 
e eth hashrate 


4.1. Command line interface and .. 


e eth gasPrice 


4.2. JSON RPC API 


4.3. JavaScript API for Dapps 


4.4. JavaScript Console 
5. Contracts and transactions 


5.1. Account types and transactions 


。 eth accounts 

e eth blockNumber 

e eth getBalance 

e eth getStorageA! 

e eth getTransactionCount 

e eth getBlockTransactonCountByHash 


e eth getBlockTransactonCountByNumber 


4-56 在 接口 文档 中 查看 接口 信息 
在 左边 的 “methods” 列 表 中 找到 “eth_ getTransactionByHash” 的 介绍 ， 便 可 以 很 简单 地 获取 


我 们 需要 的 信息 ， 如 图 4-57 所 示 。 
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eth getTransactionByHash 
Returns the information about a transaction requested by transaction hash 
Parameters 


1. DATA , 32 Bytes - hash of a transaction 


params: [ 


A 39418543484b540c1ba5579$1325b143887c6813051021687854388* cb ce558238 


] 


Returns 
Object -Atransacltion object, or null when no transaction was found 


e hash: DATA , 32 Bytes - hash of the transaction 
e nonce; QANTITY -the number of transactions made by the sender prior to this one, 
e blockHash : DATA , 32 Bytes - hash of the block where this transaction was in. null when its 
pending 
e blockNumber : QUANTITY - block number where this transaction was in. null when its pending 
e tranzactionIndex : QUANTITY - integer of the transactions index position in the block. null when 
its pending 
m: DATA , 20 Bytes - address of the sender 
* to: DATA , 20 Bytes - address of the receiver. null when its a contract creation transaction. 
è value : QUANTITY -value transferred in Wei 
e gasPrice : QUANTITY -gas price provided by the sender in Wei 
e gas: QUANTITY - gas provided by the sender 


e input: DATA -the data send along with the transaction 


Example 


4-57 eth getTransactionByHash 接口 的 文档 介绍 页 面 


“Parameters” 对 应 的 是 参数 列表 ， 可 以 看 到 只 需要 传 入 一 个 32 字 节 的 交易 哈 硕 值 ， 关 型 是 
一 个 字符 串 。“Returns ”对 应 的 是 返回 值 列 表 及 其 介绍 ， 而 “method ”就 是 第 一 行 中 的 
"eth getTransactionByHash" 。 
至此， 通过 查看 文档 ， 我 们 把 要 实现 的 “获取 交易 信息 ”接口 函数 所 需要 的 参数 都 找到 了 ， 
接 下 来 开始 编写 代码 。 


4.9.3 ”实现 获取 交易 信息 


本 节 我 们 在 “ETH RPC Requester.go” 文 件 中 完成 获取 交易 信息 接口 的 编号 。 从 上 面 的 一 节 
中 可 以 知道 ， 交 易 信 息 接 口 对 应 的 “method” 是 “eth_getTransactionByHash”， 接 下 来 我 们 在 项 目 
中 新 建 一 个 名 称 为 “model” 的 文件 夹 ， 专 门 用 来 存放 数据 结构 体 。 

在 “Goland” 中 新 建文 件 夹 的 方式 如 图 4-58 所 示 ， 将 鼠标 停放 到 “eth_relay” 文 件 夹 名 称 上 ， 
单 击 鼠标 右键 即 可 看 到 对 应 的 选项 列表 ， 然 后 单 击 “New” 一 “Directory” 选 项 。 


<th-reley [CD:\go 1.9 go path\src\eth-relay] - ..\ETH RPC Requestergo [eth-relay] - GoLand 


File Edit View Navigate Code Refactor Run Tools VCS Window Help 


""o - MTREEEEEEEEE : <- 


~ eth-relay X Cut Ctrl+X | 下 File 
"Project v @ B Copy Ctrl «C | 是 Cmd script 
Copy Path Ctrl«Shift«c | S Scratch File — Ctrl « Alt« Sh 


8 ETH RP| Copy Relative Path — Ctrli+Alt+Shift+C eb 
& ETH RP! Ë Paste Ctrl+V | a HTML File 
Weethrpcí — Find Usages Alt+F7 | ess Stylesheet 
HW maingc Find in Path... Ctrl+ Shift+F | 3s. JavaScript File 
> lllExternalLib ^ Replace in Path... Ctrl -Shift«R | msa TypeScript File 
> "Qe 5cratchesà| — |nspect Code... ( tsconfig json File 


Refactor ,| © packagejson File 


4-58 ”在 项 目 文件 夹 中 创建 男 一 个 文件 夹 
“model” 文 件 夹 创建 好 之 后 ， 在 里 面 创建 一 个 名 称 为 “transaction.go” 的 文件 来， 准备 编写 
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交易 信息 数据 所 对 应 的 变量 值 ， 如 图 4-59 所 示 。 


eth-relay |D^go 1.hgo pethNsreyeth-relay! - .vnodelvransaction.go [eth-relay] - GoLand 


File Edit View Navigate Code Refactor Run Iools VCS Window Help 


*-HSZS € TestNewETHRPCClient in eth-relay ^ > # G 


= eth-relay — model 车 transaction.go 


Projet» © — € 一 Š transaction.go 9 main.go > | * ETH RPC Cli 
v Meth-relay D:\go 1.9 go path package model 


vv model. 
E ETH RPC Client.go 
9 ETH RPC Requester.go 
5$ ethrpc test.go 
F main.go 


> Illl] External Libraries 


> "gy Scratches and Consoles 


4-59 创建 transaction.go 文件 


根据 “eth_getTransactionByHash” 接 口 对 应 的 返回 值 ， 我 们 逐个 在 “transaction.go” 文 件 中 编 
写 其 对 应 的 数据 类 型 。 在 数据 变量 类 型 映射 部 分 ， 文 档 中 所 有 标明 的 无 论 是 “Bytes”“DATA” 
还 是 “QUANTITY”， 都 可 以 使 用 “Go” 语 言 中 的 “string” 了 字符 串 类 型 与 之 对 应 。 因 为 即使 是 数 
字 人 返回 值 ， 其 格式 实际 上 也 是 一 个 十 六 进 制 的 字符 串 ， 如 图 4-60 所 示 。 


Returns 


Object -Atransaction object, or null when no transaction was found: 


e hash: DATA , 32 Bytes - hash of the transaction. 
nonce : QUANTITY -the number of transactions made by the sender prior to this one. 
blockHash : DATA , 32 Bytes - hash of the block where this transaction was in. null when its 
pending. 
blockNumber : QUANTITY - block number where this transaction was in. null when its pending. 
transactionIndex : QUANTITY -integer of the transactions index position in the block. null when 
its pending. 


from : DATA , 20 Bytes - address of the sender. 


to : DATA , 20 Bytes - address of the receiver. null when its a contract creation transaction. 
value : QUANTITY - value transferred in Wei. 


gasPrice : QUANTITY - gas price provided by the sender in Wei. 
gas : QUANTITY - gas provided by the sender. 


input : DATA -the data send along with the transaction. 
图 4-60 eth getTransactionByHash 接口 的 返回 值 及 其 介绍 


根据 对 应 关系 ， 可 以 编写 出 下 面 交 易 信 息 所 对 应 的 数据 结构 体 的 代码 。 其 中 ，“json:”xxx7”” 
的 意思 是 这 个 结构 体 可 以 被 “Json” 序 列 化 以 及 被 反 序 列 化 ， 而 “xxx” 代 表 的 是 当 结 构 体 被 序列 
化 输出 的 时 候 在 “Json” 格 式 下 所 对 应 的 名 称 。 


type Transaction struct { 


Hash string ‘ison: "hash 

Nonce string `json: "nonce" ` 
BlockHash string ^json:"blockHash"" 
BlockNumber string `json: "blockNumber" ` 


TransactionIndex string `json:"transactionIndex"` 
From string -on "from" 
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To string ISON TEDT 

Value string "json:"value"" 
GasPrice string "json:"gasPrice" 
Gas string “On "gast. 
Input string "356n:"3mput"- 


此 外 , “Transaction” 数 据 结构 体 中 的 每 个 变量 必须 是 大 写 开 头 , 原因 是 只 有 这 些 变 量 大 写 时 ， 
“Transaction ”结构 体 在 文件 外 被 实例 化 的 时 候 才 能 被 外 部 引用 ， 可 以 理解 为 公有 变量 ,例如 像 下 
面 的 引用 形式 : 


Tx := model.Transactioní)] 
Tx.Hash - "0x123456789" 


f| f xe. AB BIXAIUS A fe PED N-T RE “RPC” RKA “Cal” RA ESRO 
齐全 了 。 

现在 我 们 来 完成 “getTransactionByHash” 了 函数 ， 代 人 码 如 下 : 
// 根据 交易 的 哈 希 值 获取 对 应 交易 的 信息 
func (r *ETHRPCRequester) GetTransactionByHash (txHash string) 
(model.Transaction,error) { 


methodName := "eth getTransactionByHash" 
result := model.Transaction(í] 


// 下 面 call 函数 的 result 参数 传 入 的 是  model.Transaction 结构 体 的 引用 ， 
// 这 样 内 部 所 设置 的 值 在 函数 执行 完 之 后 才能 有 效果 


err := r.client.GetRpc().Call(&result,methodName,txHash) 
return result,err 


接 下 来 我 们 使 用 在 “获取 链接 ”一 节 中 所 获得 的 主 网 以 太 坊 节点 链接 Chttps://mainnet.infura.io 
/v3/2e6d9331f74d472a9d47fe99f697ca2b) 来 进行 获取 交易 记录 的 单元 测试 。 

站 先 到 以 太 坊 区 块 链 浏览 器 “https://etherscan.io/” 上 随便 找 一 笔 交 易 的 喻 希 值 , 进行 一 下 查询 ， 
如 图 4-61 所 示 。 


Ethereum Blockchain Explorer Quick links: ERC-20 Token 


AllFiters ~ Search by Address / Txn Hash / Block / Token / Ens 


ETHER PRICE e»; LATEST BLOCK TRANSACTIONS ETHEREUM TRANSACTIO 
< $248.18 @ 0.03169 BTC (+6.33%) 7770839 (1223) 447.75 M (11.7 TPS DAYS 


1 000k 


MARKET CAF , DIFFICULTY HASH RATE 
$26.330 Billion 4&. 2034.32 TH 160,587.05 GH/s 


Latest Blocks 一 随便 点 击 一 条 交易 


7770839 Miner Nanopoo 2.15693 Eth x0! c1.. From 0x6b20eb98625a... 


Bk 33 secs ago 146 txns in 10 secs 33 secs ag To 0x6153cd2dcO0d.. 


4-601 查询 交易 
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要 查询 的 是 : 
0x53c5b03e392d6aa68a0df26b6d466ae8fbdl1c2c5b74f9baae05434ec9a18a282 
它 所 对 应 的 数据 如 图 4-62 所 示 。 


e Etherscan All Filters 


Eth: $249.15 (+6.74% Home Blockchain v Tokens v Resources v 


Transaction Details 


Sponsored ul Ride the Bull during the ICO of the Best Online Game - Play Now! 


Overview Event Logs (1) State Changes | New | Comments 


Transaction Hash: 0x53c5b03e392d6aa68a0df26b6d466aeBfbd1c2c5b74f9baae05434ec9a218a282 [0 


Status 


Block: 075296 Block Confirmations 


Timestamp: (9 184 days 3 hrs ago (Nov-13-2018 07:16:38 AM +UTC) 


From: 0x9d84338d8503d95c35143160fc705ed5d5793f5b [0 


TO: Contract 0x78021abd9b0610456cb9db95a846c302c34f8bsd © (0D 


Tokens Transferred: » From 0x94d84338d85... To 0x37f06ad5050... For 10,000 ($1.46) E5 ERC-20 (CDCC) 


4-62 ”交易 数据 
编写 单元 测试 代码 如 下 : 


func Test GetTransactionByHash(t *testing.T) { 


nodeUrl := "https://mainnet.infura.io/v3/2e6d9331f£74d472a9d47fe99f£697ca2b" 
txHash := 


"0x53c5b03e392d6aa68a0df26b6d466ae8fbd1c2c5b74f9baae05434ec9a18a282" 


} 


if txHash == "" || len(txHash) !- 66 ( 
// 这 里 演示 在 调用 RPC 接口 函数 的 时 候 ， 要 先进 行 入 参 的 合法 性 判断 
fmt .Println ("非法 的 交易 哈 希 值 ") 
return 


} 
txInfo,err := NewETHRPCRequester (nodeUrl).GetTransactionByHash (txHash) 


if err !- nil { 
// 查询 失败 ， 打 印 出 信息 
fmt .Println(" 查 询 交 易 失 败 ， 信 息 是 : " ,err .Error () ) 
return 


} 
// 查询 成 功 ， 将 transaction 结果 的 结构 体 以 json 格式 序列 化 ， 再 以 string 格式 输出 


json, := json.Marshal (txInfo) 
fmt.Println(string(json)) 


E 行 后 ， 观 察 控制 全 的 输出 结果 ， 可 以 看 到 完整 的 交易 数据 已 经 按照 “Json” 格 式 输 出 了 ， 青 


jZ 
Hjou s PH E. BEES, ARR RDE ROROA, WE 4-63 
所 示 。 
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^. Test GetTransactionByHash in eth-relay > 
» (9) Tests passed: 1 of 1 test 1 s 63 ms 


("hash":"0x53c5b03e392d6aa68a0df26b6d466ae8fbd1c2c5b74f9baae05434ec9a18a282" , "nonce" :' 


Process finished with exit code 0 


"hash": "0x53c5b03e392d6aa68a0df26b6d466aeBfbd1c2c5b74f9baae05434ec9a18a282" 
"nonce": "0x0", 

"blockHash": "0x458ff523a4137ae7e7b60a96dec41e9af30072067f58f8dfdc64bc092bb10884" 
"blockNumber": "0x662a7d", 

"transactionIndex": "OxSb" 

"from": "*0x9d843384d8503495c351431e0fc705ed5d5793f5b", 

"to": *0x78021abd9bO06f0456cb9db95a846c302c34f8b8d', 

"value": "OxO", 

"gasPrice"; "0x1836e2100", 

"gas": "Oxea60", 

"input": "0xa9059cbb00000000000000000000000037f06ad505036b55d961024789576790be180c0100000000000000000000000000000000000000000000021 e19 


4-63 Test GetTransactionByHash 单元 测试 代码 的 运行 结果 


4.9.4 iAiR *BatchCall" E24 


上 面 我 们 完成 了 一 个 单 批 次 获取 交易 信息 的 接口 函数 ， 如 果 要 实现 根据 多 笔 交 易 的 哈 希 值 来 
获取 多 个 交易 的 信息 ， 读 者 可 能 会 想到 ， 使 用 循环 语法 就 能 达到 目的 。 例 如 ， 使 用 “for” 来 多 次 
调用 单 批 次 的 那个 接口 。 这 种 使 用 循环 的 做 法 是 可 以 的 ， 但 不 是 性 能 最 好 的 。 和 “Call” 函 数 ( 方 
法 ) 一 样 ， 以 太 坊 的 “Go” 版 本 节点 源码 除了 在 “RPC” 依 赖 包 的 “client.go ”源码 文件 中 提供 了 
“Call ”函数 (方法 ) 外 ， 还 提供 了 一 个 能 够 文 持 发 起 批量 “RPC” 请 求 的 图 数 ， 即 “BatchCall”， 
如 图 4-64 所 示 。 


// BatchCaLL sends alL given requests as a single batch and waits for the server 
// to return a response for all of them. 
/ / 
// In contrast to CaLL, BatchCall only returns I/O errors. Any error specific to 
// a request is reported through the Error field of the corresponding BatchELem. 
// 
// Note that batch calis may not be executed atomically on the server side. 
func (c *Client)[Batchcaillb []BatchElem) error ( 

ctx := context.Background( ) 

return c.BatchCallContext(ctx, b) 


} 


4-64 client.go 源码 文件 中 的 BatchCall 函数 


“BatchCall” 函 数 可 以 让 我 们 发 起 批量 的 “RPC” 请 求 ， 对 于 批量 的 查询 ,例如 交易 记录 批量 
人 查询、 批量 ERC20 代 币 余额 查询 等 ， 都 可 以 使 用 这 个 函数 来 达到 目的 。 接 下 来 我 们 认识 一 下 该 图 
数 的 入 参 “BatchElem” 。 

“BatchElem ”是 一 个 结构 体 类 型 ， 其 内 部 的 构造 如 图 4-65 所 示 。 

“method” 参 数 代 表 的 意思 和 “Call” 函 数 中 的 一 样 ， 就 是 所 要 请 求 的 以 太 坊 “RPC” 接 口 的 
名 称 。“Args” 代 表 的 是 泛 型 参数 数组 ， 数 组 内 的 每 个 元 素 一 一 对 应 每 个 单 次 请 求 所 需 的 参数 。 
“Result” 对 应 一 次 返回 的 结果 ， 类 型 是 泛 型 ， 这 个 值 在 传 入 时 一 般 是 数组 ， 即 用 数组 来 存储 返回 
的 结果 ， 数 组 内 的 每 个 元 素 对 应 的 也 是 单 次 请 求 所 产生 的 结果 。 最 后 的 一 个 “Error” 是 错误 类 型 ， 
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如 果 该 次 请 求 有 包 误 发 生 ， 那 么 将 由 它 来 存储 和 错误 有 关 的 内 容 。 


// BatchELem is an element in a batch request. 
type BatchElem struct { 
Method string 


Args | []interface() 
// The result is unmarshaled into this field. Result must be set to a 


// non-nil pointer value of the desired type, otherwise the response will be 
// discarded. 
Result interface() 


// Error is set if the server returns an error for this request, or if 
// unmarshaling into Result fails. It is not set for I/O errors. 
Error error 


4-65 BatchElem 结构 体 在 源码 中 的 定义 


4.9.5 批量 获取 交易 信息 


现在 我 们 来 使 用 “BatchCall” 孙 数 实现 批量 获取 交易 信息 的 接口 。 

首先 准备 构造 入 参 的 “BatchElem” 参 数 。 对 于 “method” 来 说 ， 我 们 依然 使 用 根据 交易 哈 希 
值 来 获取 交易 信息 的 接口 方法 ， 所 以 “method” 是 “eth getTransactionByHash" . 

因为 “eth_ getTransactionByHash” 是 根据 每 笔 交 易 的 哈 希 值 来 查询 的 ， 所 以 在 批量 查询 的 情况 
下 ，“Args” 参 数 对 应 的 就 是 哈 布 值 字符 串 的 数组 。 同 样 地 ， 此 时 的 “Result” 对 应 的 也 应 该 是 交 
易 信 息 结 构 体 “Transaction” 数 组 的 指针 。 

根据 上 面 的 分 析 ， 编 号 如 下 代码 ， 国 数 名 称 是 “GetTransactions” 。 
// 根据 交易 哈 希 值 字 符 串 的 数组 批量 获取 对 应 的 交易 信息 


func (r *ETHRPCRequester) GetTransactions(txHashs []string) 
([]*model.Transaction,error) { 

name := "eth getTransactionByHash" 

// 结果 数组 存储 的 是 每 个 请 求 的 结果 指针 ， 也 就 是 引用 

rets := []*model.Transactioní)] 

// 获取 哈 希 值 数组 的 长 度 ， 方 便 在 循环 中 逐个 实例 化 BatchElem 


Size := len(txHashs) 


reqs := []rpc.BatchElem(í] 
for i:-20;i«Xsize;i-t* { 
ret := model.Transactioní)] 
// 实例 化 每 个 BatchElem 
req := rpc.BatchElem( 
Method:name, 
Args:[]interface(í(])(txHashs[il], 
// aret 传 入 单个 请 求 的 结果 引用 ， 保 证 它 在 函数 内 部 被 修改 值 后 ， 回 到 函数 外 时 仍然 有 效 
Result: &ret, 
} 
reqs = append(reqs,req) // 将 每 个 BatchElem 添加 到 BatchElem 数组 
rets = append(rets,&ret) // 每 个 请 求 的 结果 引用 添加 到 结果 数组 中 


} 
err := r.client.GetRpc().BatchCall(reqs) // 传 入 BatchElem 数组 ， 发 起 批量 请 求 


return rets,err 


编写 单元 测试 代码 。 这 里 我 们 故意 制造 一 笔 不 存在 的 交易 ， 观 窒 查 询 后 返回 的 结果 是 什么 ， 
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有 关 合 法 交易 哈 希 值 的 获取 ， 请 参考 “实现 获取 交易 信息 ”一 节 ， 测 试 代码 如 下 : 


func Test GetTransactions(t *testing.T) ( 
nodeUrl := https://mainnet.infura.io/v3/2e6d9331f74d472a9d47fe99f697ca2b 
txHash 1:= "0x53c5b03e392d6aa68a0df26b6d466ae8fbdlc2c5b74f9baae05434ec9a18a282" 
txHash 2:- "0x53c5b03e392d6aa68a0df26b6d466ae8fbdlc2c5b74f9baae05434ec9a18a281" 
txHash 3:- "0x711ddd5f223f970aa0ebc32304a880a8c2ec45ee134b4f41dd4da264f72elafc" 


// txHash 1 是 存在 的 ， 2 是 伪造 的 ， 3 也 是 存在 的 
txHashs := []string() 
txHashs = append(txHashs,txHash l,txHash 2,txHash 3) 


if txHashs == nil || len(txHashs) == 0 ( 
// 这 里 演示 在 调用 RPC 接口 函数 的 时 候 ， 都 要 先进 行 入 参 的 合法 性 判断 
fmt .Println ("非法 的 交易 哈 希 值 数组 ") 
return 
} 
txInfos,err := NewETHRPCRequester (nodeUrl).GetTransactions (txHashs) 
if err !- nil ( 
// 碍 询 失败 ， 打 印 出 信息 
fmt .Print1ln(" 查 询 交 易 失 败 ， 信 息 是 ，"” ,err.Error () ) 
return 
} 
// 查询 成 功 ， 将 transaction 结果 的 结构 体 先 以 json 格式 序列 化 ， 再 以 string 格式 输出 
json, := json.Marshal (txInfos) 
fmt.Println(string(json)) 


最 终 返回 的 结果 如 图 4-66 所 示 ， 我 们 可 以 发 现 ， 对 于 不 存在 的 交易 得 询 后 的 结果 信息 是 ， 其 
每 个 内 部 的 字段 值 都 是 空 字符 串 。 根 据 这 个 特点 ， 我 们 就 能 通过 判断 查询 后 的 结果 结构 体 中 的 
“hash” 了 字段 值 是 不 是 空子 符 串 来 得 出 对 应 的 交易 是 否 存在 。 


[í 
"hash" 


xa9059cbb00000000000000000000000037106ad505036b55d961024789576790be180c01000000000000000000000000000000000000000000000?21 e 


DaB8c2ec45ee134b4141dd4da2654172e1afc* 


1a169ef5e143359d4e929cc2e984c55f8c* 


b000000000000000000000000bec81 b76b02c6bfee5c5f168a7154ea0c463bbba0000000000000000000000000000000000000000000000000! 


4-66 Test GetTransactions 单元 测试 函数 返回 的 数据 
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4.9.6 ”批量 获取 代 币 余额 


相对 于 交易 信息 的 查询 ， 对 钱包 地 址 所 拥有 的 链 上 “Token” 资 产 余额 数量 的 查询 更 为 重要 ， 
这 个 功能 几乎 在 所 有 的 钱包 和 交易 所 应 用 中 都 会 用 到 。 这 里 的 “Token ”现在 已 被 广泛 认为 是 代 币 ， 
“Token ”的 余额 也 就 被 称 为 是 代 币 的 余额 了 。 
本 节 我 们 依然 使 用 “BatchCall” 函 数 来 实现 一 个 专门 用 来 根据 用 户 的 以 太 坊 钱包 地 址 和 代 币 
地 址 进行 批量 代 币 余额 查询 的 接口 。 
首先 回顾 前 面 一 节 , 在 以 太 坊 中 ,“Token” 是 一 个 统称 , 基于 不 同 智能 合约 下 所 发 布 的 “Token” 
还 可 以 细 分 为 ERC20 类 “Token”、ERC721 类 “Token” 等 ， 但 是 为 了 方便 记忆 ， 我 们 统称 为 代 
m. 
在 目前 的 代 币 中 ， 主 要 分 两 大 类 ， 这 两 大 类 代 币 余额 的 获取 在 以 太 坊 节点 中 所 对 应 的 “RPC” 
接口 并 不 相同 ， 它 们 分 别 是 : 
(1)ETH (以 太 坊 ), 非 智能 合约 类 代 币 , 获取 ETH 余额 使 用 的 接口 名 称 是 “eth_ getBalance" . 
(2) 智能 合约 类 代 币 ， 例 如 CDCC， 获 取 合 约 尖 代 币 余额 的 接口 名 称 是 “eth_call”， 这 个 接 
口 的 “data” 参 数 “methodId” 部 分 取 值 为 “balanceOf” 的 哈 希 规则 值 。 


上 面 所 提 到 的 两 个 接口 包括 其 参数 的 详细 介绍 在 “重要 接口 的 含义 详解 ”和 “交易 参数 的 说 
明 ” 中 己 经 讲 过 ， 此 处 不 再 效 述 。 

1. 获取 ETH 余额 

要 编写 获取 ETH 余额 的 代 但 ， 可 按照 获取 交易 信息 接口 的 编写 步骤 进行 ， 首 先 需要 确认 好 
“methodName ”参数 、“Args” 入 参 和 返回 结果 的 结构 字段 ， 对 应 ETH 余额 的 “eth_getBalance” 
接口 ， 可 以 直接 查询 接口 文档 获得 所 需 信息 。 如 图 4-67 所 示 ，“Args” 的 参数 有 两 个 : 第 一 个 是 
所 要 查询 的 以 太 坊 地 址 ， 即 要 查询 谁 的 余额 ， 第 二 个 是 区 块 号 参数 ， 取 值 范围 是 latest, earliest 或 
pending, X 3 个 参数 的 含义 在 “重要 接口 的 含义 详解 ”一 节 中 已 经 详细 讲解 过 ， 关 于 余额 的 获取 ， 
恒定 取 值 为 “latest” 即 可 。 


eth_getBalance 


Returns the balance of the account of given address. 


Parameters 


1. DATA , 20 Bytes - address to check for balance. 
2. QUANTITY|TAG -integer block number, or the string "latest" , "earliest" Or "pending" , see the 


default block parameter 


'0x407d73d8a49eeb85d32cf465507dd71d507100c1', 
'latest' 
] 
Returns 


QUANTITY - integer of the current balance in wei. 


4-67 eth getBalance 在 文档 中 的 介绍 
以 太 坊 ETH 余额 获取 的 相关 函数 如 下 所 示 : 
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// 单 笔 查 询 : 根据 以 太 坊 地 址 ， 查 询 以 太 坊 etn 的 余额 


func (r *ETHRPCRequester) GetETHBalance (address string) (string,error) { 
name := "eth getBalance" 
result := "" 
// 对 应 文档 ， 第 一 个 参数 就 是 要 被 查询 的 以 太 坊 地 址 ， 第 二 个 参数 就 是 1atest 
err := r.client.GetRpc().Call(&result,name,address,"latest") 
zt err !—- nil 1 
return "",err 
} 
if result -- "" 
return "",errors.New("eth balance is null") 
} 
// 因为 得 询 所 返回 的 结果 是 一 个 十 进 制 的 字符 串 ， 
// 为 了 方便 阅读 ， 我 们 在 下 面 使 用 go 的 大 数 处 理 将 其 转换 为 十 进 制 数 ， 
// 并 防止 数位 溢出 
ten, := new(big.Int).SetString(result[2:],16) 
return ten.String(),nil 


) 


// 批量 查询 : 根据 以 太 坊 地 址 数组 ， 查 询 以 太 坊 eth 的 余额 
func (r *ETHRPCRequester) GetETHBalances (addresss []string) ([]string,error) { 
name := "eth getBalance" 
// 结果 数组 存储 的 是 每 个 请 求 的 结果 指针 ， 也 就 是 引用 
rets := []*string(í) 
// 获取 addresss 数组 的 长 度 ， 方 便 在 循环 中 逐个 实例 化 BatchElem 
size := len(addresss) 
reqs := []rpc.BatchElemí] 
for i:-20;i«size;i-t-* ( 
ret ;- "" 
// 实例 化 每 个 BatchElem 
req := rpc.BatchElem[( 
Method:name, 
Args:[]interfaceí](addresss[i],"latest"], 
// aret 传 入 单个 请 求 的 结果 引用 ， 保 证 它 在 函数 内 部 被 修改 值 后 ， 回 到 函数 外 时 仍然 有 效 
Result: &ret, 
} 
reqs = append(reqs,req) // 将 每 个 BatchElem 添加 到 BatchElem 数组 
rets = append(rets,&ret) // 每 个 请 求 的 结果 引用 添加 到 结果 数组 中 
} 
err := r.client.GetRpc().BatchCall(reqs) // 传 入 BatchElem 数组 ， 发 起 批量 请 求 
If err !— nri | 
return nil,err 
} 
// 查询 每 个 请 求 有 没有 错误 
for ,req := range reqs { 
if req.Error !- nil { 
return nil,req.Error // 返回 错误 
} 
} 


finalRet := [] stringt{} 
for ,item := range rets ( 
ten, := new(big.Int).SetString((*item)[2:],16) 


finalRet - append(finalRet,ten.String()) 
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return finalRet,err 


} 


代 公 最 后 返回 的 结果 处 有 一 个 技术 要 点 ， 由 于 查询 以 太 坊 “eth_getBalance ”接口 返回 的 结果 
是 一 个 十 六 进 制 的 字符 串 ， 且 这 个 数值 的 十 进 制 格式 是 乘 上 了 ETH H “decimals” AAAA, BH 
这 个 数 的 十 进 制 形式 是 很 大 的 ， 例 如 5 个 ETH， 它 在 函数 中 最 终 返 回 的 数值 转 为 十 进 制 时 是 
5 X 1018， 其 中 18 就 是 ETH 的 “decimals”( 以 太 币 单位 精确 到 小 数 点 后 的 位 数 ) ，10“ 就 是 位 数 
的 次 方 值 。 

结果 是 如 此 大 的 数值 ， 在 这 种 情况 下 ， 已 经 无 法 使 用 “int” 类 型 存储 它 ， 因 为 超过 了 “int” 
可 表示 的 最 大 数 的 上 限 。 所 以 在 处 理 以 太 坊 相关 的 大 数值 参数 或 者 结果 的 时 候 , 必须 采用 大 数 来 存 
储 ， 或 者 使 用 字符 串 来 表示 。 

同样 地 ， 在 获取 非 ETH 类 的 代 币 余额 数值 的 时 候 ， 其 最 终 的 十 进 制 格式 也 是 乘 上 合约 中 所 设 
置 的 “decimals” 位 数 的 虎 次 方 。 记 住 ， 并 不 是 所 有 的 代 币 的 “decimals ”都 是 同一 个 值 ， 在 前 和 耐 
“实现 ERC20 代 币 智能 合约 ”一 节 中 已 经 介绍 过 “decimals” 值 是 可 以 在 合约 代码 中 进行 自 定 义 设 
LH « 

在 编写 好 图 数 之 后 ， 按 照 惯 例 编写 它们 各 目 对 应 的 单元 测试 代码 ， 进 行 单元 测试 ， 将 所 得 询 
出 的 ETH 值 和 区 块 链 浏览 费 中 所 查询 出 的 值 进行 对 比 ， 即 可 验证 结果 。 单 元 测试 的 代码 如 下 ， 依 
然 是 编写 在 我 们 前 面 所 创建 的 “ethrpc test.go” 单 元 测试 文件 中 。 

// 单 笔 交 易 的 单元 测试 函数 
func Test GetETHBalance(t *testing.T) { 
nodeUrl := "https://mainnet.infura.io/v3/2e64d9331f£74d472a9d47fe99f697ca2b" 
address := "0x0D0707963952f2fBA59dD06f2b425ace40b492Fe" 
if address == "" || len(address) !- 42 { 
// 这 里 演示 在 调用 rpe 接口 函数 的 时 候 ， 都 要 先进 行 入 参 的 合法 性 判断 
fmt .Println ("非法 的 交易 地 址 值 ") 


return 
} 
balance,err := NewETHRPCRequester (nodeUrl).GetETHBalance (address) 
if err !- nil { 

// 查询 失败 ， 打 印 出 信息 

fmt .Println ("查询 eth 余额 失败 ， 信 息 是 : ",err.Error()) 

return 


} 
fmt.Println (balance) 


} 
// 批量 交易 的 单元 测试 函数 


func Test GetETHBalances(t *testing.T) { 
nodeUrl := "https://mainnet.infura.io/v3/2e6d9331f74d472a9d47fe99f697ca2b" 


address1 := "0x0D0707963952f2fBA59dD06f2b425ace40b492Fe" // 第 一 个 地 址 
address2 := "0xf89260db97765A00a343aba8e5682715804769ca" // 第 二 个 地 址 


address := []string(í(address1,address2] 
balance,err :- NewETHRPCRequester (nodeUrl).GetETHBalances (address) 


if err !- nil ( 


// 查询 失败 ， 打 印 出 信息 
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fmt .Println ("查询 eth 余额 失败 ， 信 息 是 : ",err.Error()) 
return 

] 

fmt.Println (balance) 


2.“eth_call” 获 取 合 约 类 代 币 余额 

以 太 坊 的 “eth_call” 是 一 个 功能 非常 丰富 的 接口 , 在 前 面 的 章节 中 曾 多 次 提 到 过 它 ， 并 在 “ 重 
要 接口 的 含义 详解 ”一 节 中 对 它 进 行 过 详细 的 介绍 。 本 节 要 介绍 的 获取 合约 类 代 币 余额 的 函数 也 是 
通过 访问 该 接口 来 实现 的 。 

首先 确定 “eth_call” 接 口 的 入 参 。 继 续 查 询 文 档 ， 如 图 4-68 所 示 。“Args” 对 应 的 参数 共 7 
个 ， 每 个 参数 的 含义 请 参考 “交易 参数 的 说 明 ” 一 节 ， 其 中 第 7 个 参数 是 区 块 号 ， 对 应 3 种 取 值 选 
择 ， 如 果 瑟 记 了 ， 请 务必 先 回 顾 一 下 。 


eth_call 


Executes a new message call immediately without creating a transaction on the block chain. 


Parameters 


1. object - The transaction call object 
o from: DATA , 20 Bytes - (optional) The address the transaction is send from. 
> to: DATA , 20 Bytes - The address the transaction is directed to. 
gas : QUANTITY - (optional) Integer of the gas provided for the transaction execution. eth call 
consumes zero gas, but this parameter may be needed by some executions. 
o gasPrice : QUANTITY - (optional) Integer of the gasPrice used for each paid gas 
;» value : QUANTITY - (optional) Integer of the value send with this transaction 
data : DATA - (optional) The compiled code of a contract 
2. QuANTITYV|TAG -integer block number, or the string "latest" , "earliest" or "pending" , see the 


default block parameter 


Returns 


DATA -the return value of executed contract. 


4-68 eth call 函数 在 文档 中 的 介绍 


注意 ，“eth_call” 接 口 在 查询 代 币 余额 时 ，“data” 参 数 中 的 “methodId” 必 须根 据 当 前 代 市 
对 应 智能 合约 的 余额 得 询 图 数 来 定 ， 并 没有 一 个 固定 的 值 。 

本 例 我 们 选 定 基于 ERC20 标准 的 智能 合约 余额 施 数 “balanceOf” 来 演示 在 “eth_call” 中 通过 
设置 “balanceOf” 的 “methodId” 来 达到 访问 代 币 余额 的 目的 。 

根据 “交易 参数 的 说 明 ” 一 节 中 所 谈 到 的 ，“ERC20” 标 准 余额 查询 困 数 “balanceOf” 所 对 
应 的 “methodId” 值 就 是 “0x70a08231”， 此 时 “data” 的 第 一 个 参数 就 是 所 要 查询 余额 对 应 的 以 
太 坊 地 址 ， 参 数 的 格式 也 在 “交易 参数 的 说 明 ” 一 节 做 过 详细 介绍 。 

相对 于 ETH 余额 获取 函数 ， 合 约 类 代 币 余额 的 获取 函数 相对 来 说 要 复杂 一 些 ， 因 为 它 除 了 需 
要 被 得 询 地 址 参数 之 外 ， 还 需要 合约 的 以 太 坊 地 址 及 当前 合约 所 对 应 代 币 的 “decimals” 位 数 的 值 。 

首先 定义 好 “eth_call” 接 口 所 需 的 参数 结构 ， 用 来 当 作 以 后 调用 “eth_call” 接 口 的 参数 结构 
体 ， 根 据 上 述 文档 的 提示 ， 我 们 在 项 目 中 新 建 一 个 “eth_call arg.go” 文 件 ， 用 来 放置 该 结构 体 ， 
如 图 4-69 所 示 。 
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eth-relay model ` * eth call arg.go 
E Project ~» © * 5-! | eth call arg.go 
eth-relay C^go 1.9Xghsreveth| 1 
model 
: import "github.com/ethereum/go-ethereum/common " 
3 eth call arg.go 
X transaction.go c // VKI eth call 88 & s s 
外 ETH RPC Client.go 5 type CallArg struct { 
z // common.Address E Aib aig HEA ] LIE 
3 ETH RPC Requester.go — aress 一 HD 二 
5» ethrpc test.go 


package model 


a iL Project 
< 
< 


common.Address 'json:"from"^ 
s : common.Address 'json:"to"" 
= main.go | 18 string 'json:"gas'" 
> Ml External Libraries | 11 GasPrice string 'json:"gas price" 
v f Scratches and Consoles 12 Value string 'json:"value"' 
1 Data string 'json:"data"" 
Nonce string 'json:"nonce"^ 


» Extensions 


} 


4-69 3r eth call arg.go 文件 


代码 中 的 “common.Address” 数据 类 型 是 以 太 坊 依赖 包 的 地 址 类 型 ， 其 原型 是 “[20]byte” 数 
7H. 
// 以 太 坊 eth call 的 参数 结构 体 


type CallArg struct { 
// common.Address 是 以 太 坊 依赖 包 的 地 址 类 型 ， 其 原型 是 [20]byte 数组 


From common.Address ^json:"from"' 

To common.Address '^json:"to" 

Gas String  json:"gas" 

GasPrice string ‘json:"gas price"' 

Value string '^json:"value"' 

Data string ^json:"data" // 这 个 就 是 data 
Nonce string '^json:"nonce"' 


“ERC20” 代 币 余 额 批 量 获取 的 函数 如 下 所 示 : 


// ERC20BalanceRpcReq 是 查询 ERC20 代 币 的 参数 集合 结构 体 
type ERC20BalanceRpcReq struct { 
ContractAddress string // 合约 的 以 太 坊 地 址 
UserAddress string // 用 户 的 以 太 坊 地 址 
ContractDecimal int // 合约 所 对 应 代 币 单位 精确 到 小 数 点 后 的 位 数 
} 
// 批量 查询 : 根据 以 太 坊 地 址 数组 ， 查 询 ERC20 代 币 的 余额 
func (r *ETHRPCRequester) GetERC20Balances (paramArr []ERC20BalanceRpcReq) 
([1string,error) í 
name :;— "eth call" 
methodId := "0x70a08231" // 这 个 就 是 balanceoOf 的 methodId 
// 结果 数组 存储 的 是 每 个 请 求 的 结果 指针 ， 也 就 是 引用 
rets :- []*string(í) 
// 获取 参数 数组 的 长 度 ， 方 便 在 循环 中 逐个 实例 化 BatchElem 
size := len(paramArr) 
reqs := []rpc.BatchElem(] 
for i:=0;i<size;i++ { 
ret ;- "" 
arg := &model.CallArgí] 
userAddress :- paramArr[i].UserAddress 
// 下 面 是 针对 访问 balanceof 时 的 必需 参数 ， 碍 询 余额 是 不 需要 燃料 费 的 ， 所 有 不 需要 设置 Gas 
arg.To = common.HexToAddress (paramArr[i].ContractAddress) 
// data 参数 的 组 合格 式 见 “交易 参数 的 说 明 ” 一 节 中 的 详解 
arg.Data = methodId+"000000000000000000000000"+userAddress[2:] 
// 实例 化 每 个 BatchElem 
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req := rpc.BatchElem( 
Method:name, 
Args:[]interfaceí[]í(arg,"latest"], 
// aret 传 入 单个 请 求 的 结果 引用 ， 这 样 做 是 为 保证 它 在 函数 内 部 被 修改 值 后 ， 
// 回 到 函数 外 部 时 值 仍 有 效 
Result: &ret, 
} 
reqs = append(reqs,req)  // 将 每 个 BatchElem 添加 到 BatchElem 数组 
rets = append(rets,&ret) // 每 个 请 求 的 结果 引用 添加 到 结果 数组 中 
} 
err := r.client.GetRpc().BatchCall(reqs) // 传 入 BatchElem 数 组， 发 起 批量 请 求 
if err != nil ( 
return nil,err 


} 
// 查询 每 个 请 求 有 没有 错误 
for ,req := range reqs I 
if req.Error !- nil 1 
return nil,req.Error // 返回 错误 
} 
} 
finalRet := [] stringt{} 
for ,item := range rets ( 
if *item == "" { 
continue 


} 
ten, := new(big.Int).SetString((*item)[2:],16) 
finalRet - append(finalRet,ten.String()) 

} 


return finalRet,err 


其 中 ，“ERC20BalanceRpcReq” 是 封装 的 请 求 结 构 体 ， 因 为 批量 获取 “ERC20” 代 币 的 函数 
的 入 参 达 到 了 3 个 , 为 了 方便 管理 和 保持 代码 的 可 读 性 , 所 以 将 这 些 参 数 都 放 进 一 个 结构 体内 ， 各 
行 代码 的 含义 见 注释 。 在 “data” 参 数 行 ，“000000000000000000000000” 和 “userAddress[2:] " 
的 拼接 组 成 了 “交易 参数 的 说 明 ” 一 节 中 所 讲 到 的 64 个 字符 的 参数 ， 前 面 的 20 个 零 字符 加 上 去 掉 
了 了 “0x” 字 符 的 “userAddress ”地 址 ， 共 64 个 字符 。 

单元 测试 代码 及 其 运行 结果 如 下 : 
// 单元 测试 : 批量 获取 代 币 值 


func Test GetERC20Balances(t *testing.T) { 
nodeUrl := "https://mainnet.infura.io/v3/2e6d9331f74d472a9d47fe99f697ca2b" 


address := "0xc58AD8Ff428c354bb849d1dCf1EDCcAC3F102c8E"  // 钱包 地 址 
contractl := "0x78021ABD9b06f0456cB9DB95a846C302c34f8b8D" // 合约 地 址 1 
contract2 := "0xB8c77482e45F1F44dE1745F52C74426C631bDD52" // 合约 地 址 2 


params := []ERC20BalanceRpcReq{} 
item := ERC20BalanceRpcReq{} 
item.ContractAddress = contractl 
item.UserAddress - address 
item.ContractDecimal - 18 


params - append(params,item) 
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item.ContractAddress = contract2 
params - append(params,item) 


balance,err :- NewETHRPCRequester (nodeUrl).GetERC20Balances (params) 
if err !- nil i 

// 查询 失败 ， 打 印 出 信息 

fmt .Println ("查询 eth 余额 失败 ,信息 是 : ",err.Error()) 


return 


} 
fmt.Println (balance) 


查询 结果 如 图 4-70 所 示 。 


*. Test GetERC20Balances in eth-relay 
» (9 Tests passed: 1 of 1 test - 959 ms 


«4 go setup calls» 
[171352038000000000000000 0] APRA Æ WIAA rf 


Process finished with exit code 0 


4-70 Test GetERC20Balances 单元 测试 函数 获取 ERC20 代 币 余额 的 返回 结果 


以 上 只 是 使 用 “eth_call” 接 口 的 例子 之 一 ， 在 实际 的 开发 中 ， 很 多 智能 合约 函数 的 调用 都 是 
可 以 通过 访问 该 接口 来 达到 目的 的 。 


4.9.7 ”获取 最 新 区 块 号 


以 太 坊 区 块 链 上 的 区 块 是 在 不 断 地 被 生成 的 ， 区 块 中 包含 了 数据 。 以 太 坊 中 继 对 区 块 进行 过 
历时 ， 需 要 获取 每 个 区 块 中 的 数据 ， 需 要 在 生成 的 区 块 胜出 之 后 立刻 获取 到 它 的 区 块 号 ， 然 后 使 用 
获取 区 块 信息 相关 的 接口 函数 根据 区 块 号 来 获取 到 它 的 内 部 信息 。 

以 太 坊 提供 的 获取 链 上 最 新 区 块 号 的 接口 名 称 是 “eth blockNumber”， 该 接口 不 需要 参数 ， 
返回 的 区 块 号 结果 也 是 一 个 十 六 进 制 的 字符 串 。 通过 查询 接口 文档 , 我 们 可 以 看 到 它 的 传 参 及 返回 
结果 ， 如 图 4-71 所 示 。 

依然 在 “ETH RPC Requester.go” 文 件 中 编写 请 求 代码 ， 我 们 设置 最 终 返 回 的 结果 是 一 个 大 
整数 类 型 “big.Int”。 

// 获取 以 太 坊 最 新 生成 区 块 的 区 块 号 


func (r *ETHRPCRequester) GetLatestBlockNumber() (*big.Int, error) { 
methodName :- "eth blockNumber" 
number := "" // 存储 结果 
err := r.client.client.Call(&number, methodName) // eth blockNumber 不 需要 参数 
if err !- nil { 


return ni1l，fmt.Errorf(" 获 取 最 新 区 块 号 失败 ! $s", err.Error()) 
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} 
ten, := new(big.Int) .SetString (number[2:],16) // 十 六 进 制 转 为 十 进 制 大 整数 


return ten, nil 


eth_blockNumber 


Returns the number of most recent block. 


Parameters 


none none (4 


Returns 


QUANTITY - integer of the current block number the client is on. 


Example 


curl -X POST --data '("jsonrpc":"2.0", 


4-71 eth blockNumber 在 文档 中 的 介绍 


单元 测试 代码 如 下 : 


// 单元 测试 : 获取 以 太 坊 最 新 生成 区 块 的 区 块 号 


func TestGetLatestBlockNumber(t *testing.T) { 
nodeUrl := "https://mainnet.infura.io/v3/2e64d9331f£74d472a9d47fe99f697ca2b" 


number, err :- NewETHRPCRequester (nodeUrl).GetLatestBlockNumber () 


rt gBrr !— nr [ 
// 查询 失败 ， 打 印 出 信息 
fmt .Println ("获取 区 块 号 失败 ， 信 息 是 : ", err .Error () ) 


return 


} 
fmt.Println("10 进 制 : ", number.String()) 


运行 后 可 知 ， 己 经 获取 最 新 的 区 块 号 ， 这 个 区 块 号 就 是 当前 刚刚 连接 上 以 太 坊 公 链 的 区 块 的 
号 码 ， 如 图 4-72 所 示 。 


Run: “= TestGetLatestBlockNumber in eth-relay 


> 0S rnv 三 三 Z O% 


I <4 go setup calls» 
16 进 制 : | 6896595 


"c 
sja Process finished with exit code 0 


4-72 TestGetLatestBlockNumber 单元 测试 函数 的 运行 结果 
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4.9.8 ”根据 区 块 号 获取 区 块 信息 
对 应 “获取 最 新 区 块 号 ”一 节 中 获取 的 区 块 号 ， 本 节 我 们 根据 区 块 号 来 获取 区 块 的 数据 信息 。 


以 太 坊 提供 的 接口 名 称 是 “eth getBlockByNumber”， 通 过 查询 接口 文档 ,我 们 可 以 看 到 它 的 
传 参 及 返回 结果 ， 如 图 4-73 所 示 。 


eth getBlockByNumber 


Returns information about a block by block number. 


Parameters 


1. QUANTITYITAG -integer of a block number, or the string "earliest" , "latest" Or "pending" , as in 
the default block parameter. 
2. Boolean -If true it returns the full transaction objects, if false only the hashes of the 


transactions. 


4-73 eth getBlockByNumber 在 文档 中 的 介绍 


其 中 ， 返 回 结果 和 另外 一 个 根据 区 块 哈 希 值 来 获取 区 块 信息 的 接口 是 一 样 的 ， 而 参数 则 需要 
两 个 。 第 一 个 参数 是 用 十 六 进 制 字符 串 表 示 的 区 块 号 ， 刚 好 对 应 获取 最 新 区 块 号 接口 返回 的 结果 。 
第 二 个 参数 是 个 布尔 值 ， 它 的 取 值 可 能 有 : 

€ true， 返 回 区 块 中 所 有 被 打包 进去 的 交易 的 完整 信息 数组 。 

e false， 返 回 区 块 中 所 有 被 打包 进去 的 交易 的 哈 布 值 数组 。 


在 接口 文档 中 查询 “eth getBlockByHash” 接 口 的 返回 结果 ， 我 们 可 以 看 到 能 够 获取 的 区 块 信 
A. uk 4-74 所 示 。 

信息 是 比较 丰富 的 ， 其 中 的 大 部 分 了 字段， 我 们 在 “区 块 的 组 成 ”一 节 中 都 做 过 详细 介绍 ， 其 
rp "root" HJ EXE SA SCARPE BBE "ads" E, WU "transactions" LAE 811 exp Ber Byz 
易 信 息 数 组 。 

对 于 上 述 各 个 字段 ， 我 们 需要 在 代码 中 定义 一 个 结构 体 ， 用 来 对 应 的 字段 来 存储 它们 。 在 项 
目的 “model” 文 件 夹 下 创建 “full block.go” 文 件 ， 如 图 4-75 所 示 。 


182 | 区 块 链 以 太 坊 DApp 开发 实战 


Returns 
Object -Ablock object, or null when no block was found: 


e number : QUANTITY -the block number. null when its pending block. 


hash : DATA , 32 Bytes - hash of the block. null when its pending block. 


parentHash : DATA , 32 Bytes - hash of the parent block. 


nonce : DATA , 8 Bytes - hash of the generated proof-of-work. null when its pending block. 

sha3Uncles : DATA , 32 Bytes - SHA3 of the uncles data in the block. 

logsBloom : DATA , 256 Bytes - the bloom filter for the logs of the block. null when its pending 
block. 

transactionsRoot : DATA , 32 Bytes - the root of the transaction trie of the block. 

stateRoot : DATA , 32 Bytes - the root of the final state trie of the block. 

receiptsRoot : DATA , 32 Bytes - the root of the receipts trie of the block. 

miner : DATA , 20 Bytes - the address of the beneficiary to whom the mining rewards were given. 

difficulty : QUANTITY -integer of the difficulty for this block. 

totalDifficulty : QUANTITY - integer of the total difficulty of the chain until this block. 

extraData : DATA -the "extra data" field of this block. 

size : QUANTITY - integer the size of this block in bytes. 

gasLimit : QUANTITY - the maximum gas allowed in this block. 

gasUsed : QUANTITY - the total used gas by all transactions in this block. 

timestamp : QUANTITY - the unix timestamp for when the block was collated 

transactions : Array - Array of transaction objects, or 32 Bytes transaction hashes depending on 
the last given parameter. 


uncles : Array -Array of uncle hashes. 


4-74 eth getBlockByHash 函数 的 返回 值 及 其 介绍 


3 é | . TestGetLatestBlockNumber in eth-relay v — » 


— eth-relay > ™ model > * full block.go 


Project ~ £ 一 E full block.go 
l | package model 
2 


eth-relay D^go !.9Xgo paths: 
dao 
keystores 
model 


* eth call arg.go 


| 8 full block.go | 


9 transaction.go 


tool 


4-75 创建 fll block 文件 


结构 体 代 码 如 下 所 示 ， 其 中 每 个 字段 痢 添 加 了 注释 。 


// 根据 文档 定义 出 区 块 信息 的 结构 体 
type FullBlock struct { 


Number string  ^json:"number"^  // 区 块 号 
Hash string  ^json:"hash"^  // 区 块 的 哈 希 值 
ParentHash string  ^json:"parentHash"^  // 父 区 块 的 哈 希 值 
Nonce string  ^json:"nonce"'  // 区 块 的 序列 号 
Sha3Uncles string  ^json:"sha3Uncles"^  // ?jBgpkmi e ru, 
// 那么 它 是 叔 块 的 sha3 WAE 
LogsBloom string ^json:"logsBloom"^  // 当前 区 块 的 布 隆 过 滤器 日 志 
TransactionsRoot string  ^json:"transactionsRoot"^ // 交易 默 克 尔 树 的 根部 
hash 值 
ReceiptsRoot string  ^json:"stateRoot"^  // 收据 默 克 尔 树 的 根部 的 哈 希 值 
Miner string ^json:"miner"^  // 挖 出 此 区 块 的 矿工 的 以 太 坊 地 址 值 
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Difficulty string  ^json:"difficulty"^  // 这 个 区 块 的 难度 值 
TotalDifficulty string  "^json:"totalDifficulty"^ // 这 个 块 的 链 的 总 难度 
ExtraData string `json:"extraData"`  // 区 块 的 附属 数据 

Size string  ^json:"size"^  // 这 个 区 块 总 数据 量 的 大 小 

GasLimit string  ^json:"gasLimit"^ // 区 块 的 GasLimit， 注 意 它 和 交易 的 不 一 样 
GasUsed string  ^json:"gasUsed"" // 当前 该 区 块 已 经 打包 了 的 交易 的 总 燃料 费 
Timestamp string `json:"timestamp" ` // 区 块 被 确认 核实 的 时 间 戳 ， 单 位 为 秒 
Uncles  []string  ^json:"uncles"^ // 叔 块 的 哈 希 数组 

Transactions []interface{}  ^json:"transactions"^// 所 有 被 打包 了 的 交易 的 数组 


终 根 据 区 块 号 获取 区 块 信息 的 接口 请 求 函数 如 下 所 示 ， 返 回 的 结果 就 是 上 面 所 定义 的 
“FullBlock” 区 块 结构 体 。 


// 根据 区 块 号 获取 区 块 信息 
func (r *ETHRPCRequester) GetBlockInfoByNumber (blockNumber *big.Int) 
(*model.FullBlock, error) { 


number := fmt.Sprintf("$4x", blockNumber) // 将 big.Int 转 为 十 六 进 制 字符 串 
methodName := "eth getBlockByNumber" 
fullBlock := model.FullBlock() // 区 块 信 息 结 构 体 
// eth getBlockByNumber 的 第 二 个 参数 : 
// 若是 true， 则 返回 完整 的 区 块 信息 ; 若是 false， 则 transaction 部 分 只 返回 交易 哈 希 数组 
err := r.client.client.Call(&fullBlock, methodName, number, true) 
if err !- nil { 
return nil, fmt.Errorf("get block info failed! $s", err.Error()) 
} 
if fullBlock.Number == "" ( 
return nil, fmt.Errorf("block info is empty $s",blockNumber.String()) 


} 
return &fullBlock, nil 


单元 测试 部 分 需要 结合 获取 最 新 区 块 号 的 接口 进行 ， 代 人 码 如 下 : 


// 单元 测试 : 根据 区 块 号 获取 区 块 信息 
func TestGetFullBlockInfo(t *testing.T) { 


e 


nodeUrl := "https://mainnet.infura.io/v3/2e689331£74d472a9d47f£e99f£697ca2b" 
requester :- NewETHRPCRequester (nodeUrl) 
number, | :- requester.GetLatestBlockNumber() // 获取 区 块 号 
fmt .Println(" 区 块 号 是 :\n",number) 
fullBlock, err := requester.GetBlockInfoByNumber (number) // 获取 区 块 信 息 
if err !- nil { 
// 查询 失败 ， 打 印 出 信息 
fmt .Println ("获取 区 块 信息 失败 ， 信 息 是 : ", err.Error()) 


return 


} 
// 碍 询 成 功 ， 将 区 块 结果 的 结构 体 先 以 json 格式 序列 化 ， 再 以 string 格式 输出 
jsonl, := json.Marshal(fullBlock) 


fmt .Println ("根据 区 块 号 获取 区 块 信息 :\n"， string (json1)) 


运行 后 ， 我 们 可 以 看 到 成 功 获 取 区 块 号 后 输出 的 区 块 “json ”数据 ， 数 据 量 是 比较 多 的 ， 且 都 


是 十 六 进 制 的 格式 。 如 图 4-76 所 示 。 
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Run: = TestGetFullBlockinfo in eth-relay 


>| © » © Tests passed: 1 of 1 test- 1s 771 ms 


<4 go setup calls> 
区 块 号 是 : 
6896772 
根据 区 块 号 获取 区 块 信息 : 
(" number" :"0x693c84" , "hash" : "0xda4788b39b9fdb5f8b18c9820ef5c16a3 


Process finished with exit code e 


"number": "0x693c84", 
"hash": "6xda4788b39b9fdb5f8b18c9820ef5c16a3fe4bfce621d9208d4676fcf1e75b4039", 
"parentHash": "0x2927c36f218d2650e1a3cd16084908749992df2fc16b1dbaaca25fcc6cc3913d", 
"nonce": "Ox4fc7c6dc1b5bb32f", 
"sha3Uncles": "0x29dc24b478766d55d62eb246cbc48c5287a2f4acaa20ce37212933f613668472", 
"logsBloom": "0x100618800250500408281a31c008e8086921212254c002008805801201e4330d0481a30c002820 
"transactionsRoot": "0xcc6d5ala35ee7c8a90312e9e492948774ba168a3045b0474d723dd8a5bd9b906b" , 
"stateRoot": "Ox7cbal18ebd99c8274c768f97d39d05984c41264d0c48fcb9d3968a4bdd04e7058" , 
"miner": "6x5a0b54d5dc17e0aadc383d2db43b0a0d3e029c4c" , 
"difficulty": "0x7d8b4be4861ee", 
"totalDifficulty": "0x1c200faa01744eelbcf", 
"extraData": "0x737061726b706f6f6c2d6574682d636e2d687a", 
"size": "Ox31db", 
"gasLimit": "ex7al121d", 
"gasUsed": "0x79d9c1", 
"timestamp": "0x5c162d13", 
"uncles": ["0x072b9111c173f05316e2d65f459050f1846c24cd8f427ac220e995698670e0da" ], 
"transactions": [( 
"blockHash": "0xda4788b39b9fdb5f8b18c9820ef5c16a3fe4bfc621d9208d4676fcf1e75b4039", 
"blockNumber": "6x693c84", 
"from": "0xd1c2da7eaa1f073034325f54c1c7175523d0f2e1", 
"gas": "Ox15f90", 
"gasPrice": "Ox3b9aca00909", 
"hash": "Oxf4e2446c2bad2735d0edd1c70d10ae44d3fe12e15401a218e34d8de4b40130e8479" , 
"input": "ex", 
"nonce": "Oxaf1", 
"p": "Ox51f5ddc1d38e3ecb714c76333956d65309351b7c897098c7437a60acba760859", 
"s": "Ox5fc4labcf2e5cc298d544eb524c95d1ae54e2183648084feeba51ce61899b4ea" , 
"to": "0x22c6d93a2020fcd133963b54bff4958a0ffd6752", 
"transactionIndex": "exe", 
"v": "Qx25", 
"value": "Oxde0b6b3a37640000" 


" " e 


4-76 TestGetFullBlockInfo 单元 测试 函数 获取 的 区 块 信息 
4.9.9 根据 区 块 哈 希 值 获取 区 块 信息 


除了 可 以 根据 区 块 号 获取 区 块 的 数据 外 ， 以 太 坊 还 提供 了 一 个 “eth_getBlockByHash” 接 口 ， 
该 接口 可 根据 区 块 的 “hash” 值 获取 区 块 的 信息 。 

它 和 上 一 节 所 介绍 的 根据 区 块 号 获取 区 块 信息 的 “eth_getBlockByNumber” 接 口 除了 第 一 个 参 
数 不 一 样 之 外 ， 其 他 的 调用 参数 和 返回 结果 是 一 模 一 样 的 。 在 学 习 “eth getBlockByHash” 接 口 的 
实现 之 前 ， 请 务必 先 掌 握 “ 根 据 区 块 号 获取 区 块 信 息 ” 一 节 的 内 容 ， 即 “eth_getBlockByNumber” 
接口 的 实现 。 

如 图 4-77 的 文档 所 示 ，“eth getBlockByHash” 的 第 一 个 参数 是 区 块 的 “hash” 值 。 
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eth_getBlockByHash 


Returns information about a block by hash. 


Parameters 


1. DATA , 32 Bytes - Hash of a block. 
2. Boolean -|f true itreturns the full transaction objects, if false only the hashes of the 


transactions 


params: [ 


'0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a934d05921026d1527331' , 


4-77 eth getBlockByHash 函数 在 文档 中 的 介绍 


接口 请 求 的 代码 如 下 : 


// 根据 区 块 哈 希 值 获取 区 块 信息 
func (r *ETHRPCRequester) GetBlockInfoByHash(blockHash string) (*model.FullBlock, 


error) { 
methodName := "eth getBlockByHash" 
fullBlock := model.FullBlock() // 区 块 信息 结构 体 
// eth getBlockByHash 的 第 二 个 参数 : 
// 若是 true， 则 返回 完整 的 区 块 信息 ， 若 是 false， 则 transaction 部 分 只 返回 交易 哈 希 值 数组 
err := r.client.client.Call(&fullBlock, methodName, blockHash, true) 
if err !- nil ( 
return nil, fmt.Errorf("get block info failed! $s", err.Error()) 
} 
if fullBlock.Number == "" { 
return nil, fmt.Errorf("block info is empty $s",blockHash) 
} 
return &fullBlock, nil 


单元 测试 代码 如 下 ， 所 查询 的 区 块 的 “hash”〈 哈 希 值 ) 对 应 “根据 区 块 号 获取 区 块 信息 ”一 
节 中 所 获取 的 区 块 的 “hash” 〈 哈 希 值 ) : 


// 单元 测试 : 根据 区 块 哈 希 获取 区 块 信息 
func TestGetFullBlockByBlockHash(t *testing.T) { 
nodeUrl := "https://mainnet.infura.io/v3/2e64d9331f£74d472a9d47fe99f697ca2b" 
requester :- NewETHRPCRequester (nodeUrl) 
blockHash := 
"0xda4788b39b9fdb5f8b18c9820ef5c16a3fe4bfc6214d9208d4676fcf1e75b40a9" 
// 根据 区 块 哈 希 获取 区 块 信息 
fullBlock, err := requester.GetBlockInfoByHash (blockHash) 
if err !- nil { 
// 查询 失败 ， 打 印 出 信息 
fmt .Println ("获取 区 块 信息 失败 ， 信 息 是 : ", err.Error()) 
return 
} 
json2, := json.Marshal(fullBlock) 
fmt.Println ("根据 区 块 哈 希 值 获取 区 块 信息 \n"， string(json2)) 
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运行 结果 如 图 4-78 所 示 ， 对 应 于 区 块 号 “6896772” 的 信息 。 


Run: ^. TestGetFullBlockByBlockHash in eth-relay 
» © » (9) Tests passed: 1 of 1 test- 1s 435 ms 


I <4 go setup calls» 
根据 区 块 hash 获 取 区 块 信息 


f ("number":"0x693c84" , "hash" :"0xda4788b39b9fdb5f8b18c9820ef5c16a3fe4bfc621d9208d4676fcf1e75b40a9" , "p 


Process finished with exit code 6 


4-78 区 块 号 “6896772” 的 信息 


4.9.40 使 用 “eth _ call” 访 问 智 能 合约 函数 


YE “eth call 获取 合约 类 代 币 余额 ”一 节 中 我 们 已 经 学 习 了 如 何 使 用 “eth_ call”, UKENE 
来 调用 智能 合约 的 “balanceOf” 函 数 。 在 这 一 节 中 ， 我 们 再 使 用 它 来 调用 在 第 3 章 中 所 发 布 的 加 
法 运算 智能 合约 中 的 加 法 函数 。 
调用 智能 合约 中 的 函数 ， 先 要 找到 以 下 必需 的 信息 : 
(1) 被 调用 的 智能 合约 的 以 太 坊 地 址 。 
(2) 智能 合约 中 被 访问 函数 的 “methodId”。 
(3) Will EX. 
由 “实现 加 法 程序 ”一 节 的 内 容 可 知 ， 加 法 智能 合约 中 两 数 相 加 的 函数 定义 如 下 : 


function add(uint8 argl,uint8 arg2) public pure returns (uint8) 


函数 名 称 是 “add”， 接 收 两 个 无 符号 8 位 整 型 参数 ， 最 终 返回 的 结果 也 是 无 符号 8 位 整 型 数 


此 外 加 法 智能 合约 发 布 在 以 太 坊 主 网 上 的 地 址 是 : 
0x339dbB357E3BD3c349a912ac3a5A6D4079216911 


1. 生 成 “methodld” 
要 使 用 “eth_call” 来 访问 智能 合约 的 函数 ， 必 须根 据 函 数 的 名 称 生 成 对 应 的 “methodId”。 
“methodId” 的 生成 算法 比较 复杂 , 一 般 我 们 不 需要 目 己 编写 核心 代码 来 生成 , 而 是 直接 使 用 

以 太 坊 源码 中 提供 的 函数 来 生成 。 

这 个 封装 了 “methodId” 生 成 函数 的 源码 文件 〈 见 图 书 4-79) 是 : 

go path/src/github.com/ethereum/gp-ethereum/accounts/abi/abi.go 

可 以 使 用 “ABI” 结 构 体 中 的 “Methods” 成 员 变 量 来 选 出 对 应 的 “Method” 对 象 ， 然 后 调用 
“Method” 对 和 象 内 的 “Id() ”函数 来 生成 “methodId”。 如 图 4-80 所 示 ，“1Id()” 就 是 “Method” 
对 象 所 在 的 “method.go” 代 码 文件 中 的 一 个 函数 。 
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ethereum go-ethereum accounts abi 


/^/ The ABI holds information about a contra: 


'/ invokable methods. It will al 


// packs data accordingly. 
type ABI struct ( 
C 


MI C) 


Methods map[string]Method 


map|string]|Event 


) 


// JSON returns a parsed ABI interface and e 
func JSON(reader io.Reader) (ABI, error) ( 
dec := json.NewDecoder (reader) 


var abi ABI 
if err ;= dec.Decode(&abi); err != nil { 
return ABI(), err 


) 


return abi, nil 


} 


'/ Pack the given method name to conform the ABI. 


4-79 ”以 太 坊 Go 版 本 源码 中 的 abigo 代码 文件 


iot , 一 f e f 
Method callL's data 


Src github.com ethereum go-ethereum accounts i| * method.go 


* abigo - 这 method.go 
c 55 outputs[i] += output.Type.String() 


constant := "" 
if method.Const ( 
constant - "constant " 


) 


return fmt.Sprintf( format: "function Xv(Xv) Xsreturns(Xv)", method.Name, strings.2J 


func (method Method) Id() []byte ( 
return crypto.Keccak256([]byte(method.Sig()))[:4] 


} 


4-80 以太 坊 Go 版 本 源码 中 提供 了 生成 methodId 的 函数 
因为 生成 “methodId” 的 是 一 个 协助 图 数 ， 所 以 我 们 把 它 的 代码 也 编写 到 “tool” 文 件 夹 下 的 


“wallet.go” 文 件 中 。 
代码 如 下 ， 在 实例 化 “ABI” 绪 构 体 对 象 指针 后 ， 使 用 智能 合约 的 “abi” 数 据 来 初始 化 其 内 
部 的 变量 ， 其 中 智能 合约 的 “abi” 数 据 的 介绍 与 提取 参见 3.9.2 节 和 3.9.3 节 的 内 容 。 


// 根据 函数 的 名 称 生成 methodId. abistr 是 智能 合约 的 “abi” 数 据 
func MakeMethoId(methodName string,abiStr string) (string,error) ( 
abi := &abi.ABI() // 实例 化 “ABI” 结构 体 对 象 指针 
err := abi.UnmarshalJSON([]byte (abiStr)) 
if err !- nil ( 
reéburn "".aGrr 


} 

// 根据 methodName 获取 对 应 的 Method 对 象 

method := abi.Methods [nethodName] 

methodIdBytes := method.Id() // 调用 生成 methodrd 的 函数 
methodId := "0x"+common .Bytes2Hex (methodIdBytes) 


return methodId,nil 


加 法 智能 合约 的 “abi” 数 据 是 : 


ei "constant"; Lrue, "inputs"; | [| "hame": Targi" p "Lype":; "uintB" ), [ "name": 
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人 下 下 下 三 
"uint8" ]) ], "payable": false, "stateMutability": "pure", "type": "function" p] 


单元 测试 代码 编写 在 “tool test.go” 文 件 中 ， 如 下 所 示 : 


// 单元 测试 : 生成 methodId 
func Test MakeMethodId(t *testing.T) ( 
contractABI := // 加 法 智能 合约 的 abi 数据 
T d constant": rrüe, "a3nputbs"; | | "name": 
| "noma". "args". "LEype"z: "uintB" ol 
"hamp"- "adg". "Outpubs"- [I | "nampB": "". "types": "n1intB" | 1, 
"payable": false, "stateMutability": "pure", "type": "function" } ]'; 
methodName := "add" // 加 法 函数 名 称 
methodId,err := MakeMethoId (methodName, contractABI) 
if err !- nil { 


fmt .Println(" 生 成 methodId 失败 " ,err .Error () ) 
return 


"uargi"., "pun" "anti" 


} 
fmt .Println ("生成 methodId 成 功 ",methodId) 


单元 测试 运行 结果 如 图 4-81 所 示 。 可 以 看 到 ， 最 终 图 数 名 称 为 “add” 的 “methodId” 是 
“Oxbb4e3f4d”。 


‘» Test MakeMethodid in tool test.go 


Process finished with exit code 0 


图 4-81 测试 运行 结果 
2.5718] “add” AŽ 
接 下 来 我 们 使 用 以 太 坊 提供 的 接口 “eth_call” 来 访问 合约 中 的 “add” 了 函数， 并 将 结果 输出 。 
在 编写 访问 智能 合约 的 “add” 函 数 之 前 ， 首 先 在 以 太 坊 请 求 者 “ETH RPC Requester.go" X 
件 中 完成 一 个 通用 请 求 以 太 坊 “eth call” 接 口 的 函数 ， 代 码 如 下 所 示 。 其 中 ， 
结构 体 是 “eth_ call” 参 数 的 集合 结构 体 。 


// 使 用 eth. call 调用 智能 合约 的 函数 
// 第 一 个 参数 是 接收 结果 的 结构 体 ， 第 二 个 参数 是 eth call 参数 集合 结构 体 


func (r *ETHRPCRequester) ETHCall(result interface{},arg model.CallArg) error ( 
methodName :- "eth call" 


err :- r.client.client.Call(result, methodName, arg,"latest") 
if err !- nil { 


return fmt.Errorf("eth call failed! $s", err.Error()) 


" model.CallArg " 


} 


return nil 
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在 “ETHCall” 的 单元 测试 里 ， 我 们 结合 上 一 节 的 “MakeMethodId” 函 数 来 实现 访问 加 法 智能 
FAR “add” AZt. 
单元 测试 代码 如 下 : 


// 单元 测试 : 使 用 eth call 访问 智能 合约 的 函数 
func Test ETHCall(t *testing.T) ( 
contractABI := // 加 法 智能 合约 的 abi 数据 
"u-f "constont"* trno, "anpüuLs": |J [ "name": "argI", "type": "uinbEB" Hh 
Io “nom T rgt; iv "usnLt8 ^ EF 
"nume": "adg". "outputs": Ue "nümpB"; ""."Lype"; "uinrtB" 1.1. 


"payable": false, "stateMutability": "pure", "type": "function" } 1} 
methodName := "add" // 智能 合约 中 的 函数 名 称 
methodId,err := tool.MakeMethoId (methodName,contractABI) // 生成 对 应 的 methodId 
if err !- nil { 

panic (err) 


} 
// 下 面 要 进行 的 运算 是 : 243 
argl := common.HexToHash("2").String()[2:] // 根 据 data 中 的 参数 格式 ， 生 成 第 一 个 参数 
// argl = 0000000000000000000000000000000000000000000000000000000000000002 
arg2 := common.HexToHash("3").String()[2:] // 根 据 data 中 的 参数 格式 ， 生 成 第 二 个 参数 
// arg2 = 0000000000000000000000000000000000000000000000000000000000000003 
contractAddress := "0x339dbB357E3BD3c349a912ac3a5A6D4079216911" // 智能 合约 地 址 
args := model.CallArg(í( 

To : common.HexToAddress(contractAddress), // 此 时 的 to 对 应 的 是 合约 的 地 址 ， 代 

表 访 问 该 合约 

Data: methodId + argl + arg2, // 组 合成 data 的 完整 格式 

// 下 面 的 无 关 参 数 可 以 不 进行 赋值 ， 让 和 它们 使 用 默认 值 

//Gas: "0x0", 

//GasPrice:"0x0", 

//Value: "0x0", 

//Nonce: "0x0", 
} 
result := "" // 结果 是 一 个 十 六 进 制 字符 串 
nodeUrl := https://mainnet.infura.io/v3/2e6d9331f74d472a9d47fe99f697ca2b 
requester := NewETHRPCRequester (nodeUrl) 
err = requester.ETHCall(&result,args) // 进行 调用 
if err !- nil { 

panic (err) 
} 
ten, := new(big.Int).SetString(result[2:],16) // 将 十 六 进 制 结果 转 为 十 进 制 
fmt .Print1ln(" 调 用 合约 两 数 相 加 结果 是 : ",ten.String() 


运行 结果 如 图 4-82 所 示 。 可 以 看 到 智能 合约 已 经 帮 有 我们 计算 出 了 “2+3” 的 结果 ， 即 “5”。 
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» Test ETHCall in ethrpc test.go 


<4 go C ID 3 » 
调用 合约 两 数 相 加 结果 是 : 5 


Process finished with exit code 0 


图 4-82 调用 链 上 的 加 法 智能 合约 后 返回 的 结果 


以 上 就 是 一 个 使 用 以 太 坊 的 “eth_call” 接 口 访问 智能 合约 函数 的 例子 。 它 表明 了 一 般 的 访问 
流程 ， 无 论 智能 合约 中 的 函数 具备 什么 功能 ， 都 能 通过 上 面 的 操作 流程 进行 访问 。 需 要 注意 的 是 ， 
打包 进 区 块 的 合约 函数 不 能 使 用 “eth_call” 来 访问 触发 ， 因 为 这 种 情况 属于 以 太 坊 交易 ， 请 务必 
使 用 以 太 坊 的 发 送 交易 接口 进行 访问 触发 。 


本 草 将 综合 运用 前 面 各 革 内 容 ， 使 用 绝 大 部 分 以 太 坊 RPC 接口 请 求 函数 ， 采 用 Go 语言 实现 
在 以 太 坊 DApp 应 用 中 一 个 很 强大 的 中 继 服 务 文 持 程序 ， 包 插 钱 包 、 以 太 坊 交易 、 区 块 链 分 又 检测 
以 及 分 又 区 块 数据 的 存储 回 深 操作 等 内 容 。 


5.1 创建 以 太 坊 钱包 


以 太 坊 钱包 的 创建 是 我 们 获取 并 使 用 属于 目 己 的 以 太 坊 地 址 的 唯一 途径 。 

钱包 的 创建 一 般 多 见于 基于 移动 App 的 软件 中 ， 也 就 是 钱包 App 软件 。 这 类 钱包 App 软件 的 
钱包 创建 功能 都 是 脱离 服务 顺 端 的 ， 也 就 是 可 以 直接 离线 断 网 在 App 中 进行 钱包 生成 。 之 所 以 脱 
离 网 络 连接 进行 钱包 的 生成 ， 主 要 有 两 个 原因 : 


(1) 钱包 的 创建 在 代码 层面 涉及 大 量 的 数学 运算 ， 是 比较 耗 时 的 ， 不 适合 在 服务 伏 妆 进 
行 生 成 。 
(2) 可 以 100% 避 免 在 创建 钱包 的 时 候 衫 抓 包 拦截 ， 钱 包 信息 被 截 取 。 如 图 5-1 所 示 是 钱包 
由 服务 器 闯 生 成 再 将 信息 传递 回 客户 问 的 一 个 汗 示 ， 其 间 可 能 会 市 来 风险 。 
虽然 钱包 多 由 App 生成 ,但 在 一 些 业 务 场 景 下 也 需要 由 服务 器 问 来 帮助 用 户 生成 钱包 ， 例 如 : 
e 中 心 化 钱包 。 为 避免 小 白 用 户 不 会 操作 ， 让 用 户 一 键 生成 钱包 。 
e 中 心 化 交易 所 。 用 户 一 个 账户 对 应 多 币 种 钱包 ， 这 种 情况 可 由 服务 器 端 生成 并 保存 私 钥 等 信 
息 。 
e 在 服务 器 端 生成 钱包 。 可 以 设计 在 钱包 创建 成 功 时 不 返回 钱包 相关 的 私密 信息 给 客户 端 ， 以 
避免 钱包 信息 被 抓 包 截 取 的 问题 。 
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1. 用 户 连 接 了 公共 WIFI 网 络 ， 使 用 钱包 软件 
2. C/S 交互 的 数据 没有 加 密 传输 


申请 生成 钱包 
一 
E A “生成 成 功 ， 返 回 助 记 词 服务 器 
客户 端 | 
: 抓 包 得 到 了 
: 用 户 的 钱包 信息 


非法 分 子 


5-1. 抓 包 拦截 获取 钱包 信息 的 演示 


5.1.1 以 太 坊 钱包 术语 


在 使 用 代码 创建 以 太 坊 钱 包 之 前 ， 一 定 要 先 理 清 楚 与 以 太 坊 钱包 相关 的 术语 。 在 前 面 的 “地 
址 的 含义 ”一 节 和 “Mist” 部 分 的 “创建 以 太 坊 钱包 ”一 市 我 们 对 以 太 坊 的 相关 术语 已 经 做 过 一 些 
介绍 ， 这 里 我 们 再 做 一 个 全 面 详细 的 总 结 。 


(1) 钱包 ， 是 基于 交易 所 的 一 种 客户 端 钱 包 管 理 软件 。 我 们 可 以 用 钱包 管理 目 己 基于 当前 这 
个 交易 所 的 虚拟 货币 资产 ,钱包 里 的 所 有 信息 (例如 公 钥 、 私 钥 ) 都 基于 我 们 在 这 个 钱包 软件 上 所 
注册 的 账号 。 

(2) 账户 地 址 ， 又 称 钱包 地 址 ， 一 般 不 等 于 公 钥 ， 但 不 排除 用 户 使 用 的 交易 所 内 部 的 代码 将 
其 设 管 为 公 钥 。 一 般 账户 地 址 由 公 钥 和 特定 的 算法 生成 , 例如 由 喻 希 算 法 生成 。 账户 地 址 与 算法 和 
公 钥 的 关系 如 下 : 


算法 + 公 钥 = 账 己 地址 
(3) 密码 ， 由 交易 所 制定 ， 为 保护 我 们 的 钱包 信息 而 设置 的 ， 主 要 用 于 加 密 私 钥 。 密 码 的 作 
用 如 下 : 


e 登录 App. fjdez 2) AEk X4 App. 
e 加 密 私 钥 ， 使 之 形成 Keystore 文件 。 


(4) 公 钥 ， 由 私 钥 通过 茶 些 算法 生成 ， 比 如 第 见 的 椭圆 曲线 加 密 算 法 。 其 中 ， 公 钥 和 私 钥 的 
关系 如 下 : 
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e 私 钥 可 以 计算 出 公 和 钥 ， 公 和 角 不 能 计算 出 私 钥 。 
e 被 公 钥 锁 加 窗 了 的 数据 ， 只 能 使 用 私 钥 解 窗 。 
e 。 私 钥 加 黎 数 据 这 个 步骤 ， 一 般 称 为 数字 签名 。 


C5) 私 钥 ， 是 随机 生成 的 ， 这 个 随机 数 可 能 有 2 种 。 私 钥 的 生成 在 钱包 中 的 体现 是 ， 在 我 
们 创建 好 账号 后 代码 目 动 生成 ， 并 使 用 我 们 的 账户 密码 进行 加 密 ， 形 成 KeyStore 文件 ， 保 存在 手 
机 本 地 或 交易 所 的 数据 库 中 。 
私 钥 、 公 和 钥 与 账户 地 址 的 关系 如 下 : 
e 算法 步骤 。 首 先 根据 非 对 称 加 密 算法 中 的 椭圆 曲线 算法 的 要 求 ， 生 成 一 个 随机 数 作 为 私 铀 ， 
再 由 私 钥 根据 椭圆 曲线 算法 (ECDSA-secp256k1 ) 生成 公 钥 ， 从 公 钼 的 哈 希 值 中 提取 部 分 字 
符 串 得 出 账户 地 址 。 
@ 生成 步骤 。 
> 随机 产生 一 个 私 铀 。 
> 私 钥 通过 “ECDSA-secp2S6K1” 算 法 生成 公 钥 ， 即 计算 得 到 私 钥 在 椭圆 曲线 上 对 应 的 公 
4A. 
> IMMAR SHA3 计算 ， 得 到 一 个 哈 希 值 ， 取 这 个 哈 希 值 的 后 20 个 字 节 作为 账户 地 址 。 
私 钥 保存 在 交易 所 里 ， 风 险 很 大 ， 如 被 黑客 盗窃 ， 就 会 造成 财产 失窃 。 
私 钥 签名 的 数据 可 以 用 公 铀 解 签 。 
私 钥 加 密 数 据 ， 我 们 称 之 为 数字 签名 。 
私 钥 的 导出 : 账户 密码 +KeyStore 文件 + 加 密 算法 = 私 钥 。 
某 些 中 心 化 交易 所 App 或 钱包 App 不 提供 导出 功能 ， 此 时 用 户 便 无 法 知道 私 铀 。 


(6) 助 记 词 。 当 我 们 忘记 了 所 使 用 的 交易 所 App 或 钱包 App 的 登录 密码 ， 可 用 助 记 词 修改 
密码 。 理 论 上 ， 不 是 所 有 的 交易 所 App 或 钱包 App 都 提供 这 个 功能 。 

e 助 记 词 一 般 由 12 或 24 个 单词 构成 ，2 个 单词 之 间 由 1 个 空格 隔 开 ， 这 些 单词 都 来 源 于 一 个 
固定 词 库 (单词 表 ) 。 
组 成 助 记 词 的 单词 根据 一 定 的 算法 挑选 得 出 。 
助 记 词 实际 上 就 是 私 钥 的 另 一 种 表现 形式 。 
重要 性 和 私 钥 一 样 。 
助 记 词 能 生成 私 钥 ， 但 不 能 根据 私 钥 推出 助 记 词 。 


(7) Keystore， 一 个 用 来 存储 私 钥 数据 的 被 加 密 了 的 文件 。 如 果 没 有 对 应 的 加 密 密 码 ， 很 难 
获得 该 文件 的 私 钥 。 
e 账户 密码 + 私 钥 + 加 密 算 法 =Keystore。 
e  Keystore 数据 使 用 Json 格式 存储 。 
e 使 用 Keystore 文件 恢复 私 钥 时 ， 只 需 输 入 加 密 密 码 ， 私 钥 就 能 从 Keystore 文件 恢复 出 来 。 
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5.1.2 ”创建 钱包 


在 服务 器 端 创建 以 太 坊 钱包 ， 不 需要 进行 以 太 坊 节点 接口 的 访问 ， 可 以 直接 使 用 以 太 坊 源码 
提供 的 依赖 库 来 实现 。 

如 图 5-2 所 示 ， 位 于 “gopath” 下 的 “NewAccount” 就 是 官方 提供 的 可 以 用 来 创建 以 太 坊 钱包 
的 函数 : 


github.com/ethereum/go-ethereum/accounts/keystore/keystore.go 


go 1.9 github.com ethereum go-ethereum accounts keystore | * keystore.go 
Project ~ Qo* 9-1 À keystore.go | ——— — — 
eth-relay Càgo_1.9\lgh \srcveth] 403 ] 
model | 404 } 
405 
8 eth call arg.go 2: ] er | i 
E n 40€ // NewAccount generates a new key and stores it into the key directory, 
| 407 // encrypting it with the passphrase. 
ï ETH RPC Client.go | 408 func (ks *keystore) passphrase string) (accounts.Account, error) { 
8 ETH RPC Requester.go _, account, err ;= storeNewKey(ks.storage, crand.Readenr, passphrase) 
& ethrpc test.go if err != nl { 
return accounts.Accounti[), err 


E transaction.go 


9 main.go 
lli External Libraries 
j| Scratches and Consoles 
Fxtensions 


// than waiting for file system notifications to pick it up. 
ks.cache.add(account) 

ks.refreshWallets() 

return account, nil 


409 

4 

4 

4. 

413 // Add the account to the cache immediately rather 
4 

4 

4 

417 

| 418 


5-2 ”以 太 坊 Go 版 源码 中 的 根据 密码 生成 钱包 的 函数 


// NewAccount generates a new key and stores it into the key directory, 
// encrypting it with the passphrase. 
func (ks *KeyStore) NewAccount(passphrase string) (accounts.Account, error) { 
,, account, err := storeNewKey(ks.storage, crand.Reader, passphrase) 
if err !- nil ( 
return accounts.Accountí(], err 
} 
// Add the account to the cache immediately rather 
// than waiting for file system notifications to pick it up. 
ks.cache.add (account) 
ks.refreshWallets() 
return account, nil 


其 中 ，“passphrase” 是 设置 的 密码 参数 ， 最 终 会 用 来 结合 私 钥 生成 “keystore” 文 件 。 创 建 钱 
包 的 步骤 是 : 


(1) 根据 随机 数 创建 “ 私 钥 ”。 

(2) 根据 私 钥 生 成 “ 公 和 钥 ”。 

(3) 根据 公 钥 生成 “钱包 地 址 ”。 

(4) 将 “ 私 钥 ” 结 合 所 设置 的 “密码 ”生成 “keystore ”文件 ， 存 储 起 来 。 


要 想 使 用 “NewAccount” 畏 数 ， 首 先 须 实例 化 一 个 “KeyStore” 对 象 ， 因 为 “NewAccount” 
图 数 被 定义 为 “func (ks*KeyStore)” 类 型 ， 代 表 它 是 实例 指针 的 公有 好 数 。 

在 钱包 创建 成 功 后 ， 所 生成 的 “keystore ”文件 还 要 被 存储 起 来 ， 所 以 需要 指定 一 个 存储 
“keystore ”文件 的 文件 来。 我 们 在 项 目 主 文件 夹 下 创建 一 个 子 文件 夹 “keystores ”， 用 来 存储 钱 
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H] “keystore” XF, wA 5-3 所 示 。 


accounts 


EF Project v - d Ea keystore. go 


v eth-relay C^ao 1.9\lgh\src\eth-relay 405 
keystores 4065 /7 NewAccount generates a new key and stores it in 
8j enc pting it with the passphrase. 


leí model 408 func ds sisi aas a string) ( 
[^i eth call arg.go 409 _, account, err ;= storeNewKey(ks.storage, cran 
: if err !- nil { 
return accounts.Accountij, err 


E transaction.go 
& ETH RPC Client.go 4 
CI ETH RPC Requester.go 4 / d Ade e aci nt to the cache immediately rat 


& eth test 414 // than waiting for file system notifications t 
es EEI 415 lis ry “add(account) 
5 main.go LE ks.nefreshWallets() 


> Illi External Libraries return account, nil 


v BScratches and Consoles 
» Extensions 28 // Export exports as a JSON key, encrypted with new 
} func (ks *KeyStore) Export(a accounts. irse pass 
_, key, err := ks.getDecryptedKey(a, passphrase 
if err !- nil { 
return KeyJSON: nil, err 


5-3 ”创建 一 个 用 来 存储 钱包 文件 的 子 文件 夹 “keystores” 


创建 钱包 的 函数 依然 编 瑟 在 “ETH RPC Requester.go ”文件 中 ， 代 人 码 如 下 : 


// 创建 以 太 坊 钱 包 
func (r *ETHRPCRequester) CreateETHWallet(password string) (string,error) 
if password == "" { 
return "",errors.New("password cant empty") 
} 
if len(password) < 6 ( 
return "",errors.New("password's len must more than 6 words") 
} 
keydir := "./keystores" // 用 来 存储 所 创建 的 钱包 的 keystore 文件 的 文件 夹 
// StandardScryptN 是 Scrypt 加 密 算 法 的 标准 N 参数 
// StandardScryptP 是 Scrypt 加 密 算 法 的 标准 P 参数 
ks := keystore.NewKeyStore(keydir, keystore.StandardScryptN, 
keystore.StandardScryptP) 
wallet, err := ks.NewAccount(password) // 传 入 密码 ， 创 建 钱 包 
if err !- nil ( 
return "Ox", err 


} 
return wallet.Address.String(),nil 


单元 测试 代码 如 下 : 


// 单元 测试 : 创建 以 太 坊 钱包 
func Test CreateETHWallet(t *testing.T) { 


{ 
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nodeUrl := "https://mainnet.infura.io/v3/2e64d9331f£74d472a9d47fe99f697ca2b" 


addressl,err :- NewETHRPCRequester (nodeUrl).CreateETHWallet ("13456") 
// 演示 密码 太 短 的 错误 
if err != nil { 
fmt .Println ("第 一 次 ,创建 钱包 失败 ",err .Error () ) 
Jelse( 
fmt .Println(" 第 一 次 ， 创 建 钱包 成 功 ， 以 太 坊 地 址 是 : ",address1) 
} 
address2,err := NewETHRPCRequester (nodeUrl).CreateETHWallet ("13456aa") 


// 创建 成 功 


if err != nil { 
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fmt .Println(" 第 二 次 ， 创 建 钱包 失败 ",err .Error () ) 
}else { 


fmt .Println(" 第 二 次 ， 创 建 钱包 成 功 ， 以 太 坊 地 址 是 : ", address2) 


Run: = Test CreateETHWallet in eth-relay 
®© » (Tests passed: 1 of 1 test - 695 ms 
© <4 go setup calls> 


第 一 砍 ， 创 建 钱 包 失 败 password's len must more than 6 words 
第 二 次 ， 创建 钱 包 成 功 ， 以 太 坊 地 址 是 : | 0x590c3D81B70DdfF32F74E51f14805915a4C0e2eD 


Process finished with exit code 0 


图 5-4 Test CreateETHWallet 单元 测试 函数 的 运行 结果 
如 图 5-4 所 示 ， 新 创建 好 的 以 太 坊 钱包 地 址 是 0x590c3D81B70DdfF32F74E51f14805915a4C0e2eD. 
进入 “keystores” 文 件 夹 ， 查 看 是 耕 生 成 了 对 应 钱包 的 “keystore ”文件 ， 如 图 5-5 所 示 ， 从 
中 可 以 看 到 ， 己 经 成 功 生 成 了 。 双 击 打开 生成 的 文件 ， 还 能 看 到 以 太 坊 钱包 生成 的 地 址 信息 。 


eth-relay > = ethrpc test.go 


ÉH Project ~ O X 1- | € keystore.go 5 ETH RPC Requester.go & eth 


v eth-relay C^go 1.9MghNsreveth-relay 22 if err !- nil { 
v m keystores 24 // 查询 失败 ， 打 印 出 信息 
25 fmt.Println( a: "查询 eth RA 
model 26 return 
8 eth call arg.go 28 fmt.Println(balance) 
8 transaction.go 29 l 
9$ ETH RPC Client.go 
E ETH RPC Requester.go 
S ethrpc test.go 
9 main.go 
> Ill External Libraries 
v É} Scratches and Consoles 


// TMR: 创建 以 太 护 钱包 
func Test CreateETHWallet(t *testing.T 
nodelrl := "https://mainnet.infura 
addressl,err := NewETHRPCRequester( 
if err != nil { 
fat.Println( a: "第 一 次 ， 创 建 钱 
telse{ 
fmt.Println( a: "第 一 次 ， 创 建 钱 


》 Extensions 


LJ LEN LN M 00 1 1 ON 
UJ i UJ UJ J WwW J Ww Ju 
O CÓ s C m TEM N ®© 


} 


— 
» D 


keystores > Æ UTC--2018-12-05T03-30-40.8524428007Z--590c3d81b7... 
人 x:-"» A» ethrpc test.go * | & UIC--2018-12-05T03-30-40.8524428007 --590c3d81b70ddff32f74 
eth-relay C^9o 1.9\gh\src\eth-relay| 1 ("address" :"590c3d81b78ddff 32f74e51f14805915a4c0e2ed" J" crypto" : ("cip 


keystores 
= UTC--2018-12-05T03-30-40.852 
model 
B eth call arg.go 
8 transaction.go 

E ETH RPC Client.go 

8 ETH RPC Requester.go 


9 ethrpc test.go 


5-5 ”查看 所 生成 钱包 对 应 的 keystore 文件 
至 此 ， 我 们 成 功 地 生成 了 一 个 以 太 坊 钱包 ， 如 果 需 要 将 这 个 钱包 导入 其 他 的 钱包 软件 中 使 用 ， 
只 需 在 钱包 软件 中 选择 导入 “keystore”， 再 将 上 述 “keystore” 文 件 中 的 内 容 复 制 并 粘贴 进去 ， 最 
后 输入 创建 钱包 时 所 设置 的 密码 即 可 。 
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用 来 保存 所 有 被 创建 钱包 的 “keystore” 文 件 的 文件 夹 “keystores”， 实 际 上 相当 于 存储 了 


用 户 的 钱包 信息 。 如 果 将 这 里 的 某 个 keystore 文件 加 上 用 户 在 创建 它 时 所 设置 的 密码 , 就 
恢复 出 这 个 keystore 文件 所 对 应 的 私 钥 。 这 就 是 现在 的 中 心 化 交易 所 存储 用 户 钱 Eee "€ 
般 做 法 。 


5.2 ”实现 以 太 坊 交易 


要 实现 “以 太 坊 交易 ”功能 ， 一 般 在 前 端 通过 编写 代码 就 能 达到 目的 。 例 如 ， 在 移动 App 或 
者 网 站 上 依靠 JavaScript 语言 就 能 实现 以 太 坊 的 交易 功能 ， 而 不 需要 依赖 后 端 服务 来 实现 。 但 是 ， 
在 中 心 化 交易 所 里 ， 一 些 交 易 功 能 往往 需要 在 服务 器 端 实现 。 例 如 ，“ 用 户 提现 ”功能 就 是 从 公 链 
上 将 资产 转账 到 用 户 的 钱包 地 址 里 。 当 然 ， 通 过 客服 向 钱包 地 址 转账 也 是 可 以 的 , 但 是 当 用 户 发 起 
“提现 ”请 求 的 量 很 大 时 ， 人 为 操作 不 仅 效率 低下 ， 还 需要 专门 招聘 交易 管理 人 员 。 除 了 交易 所 的 
“用 户 提现 ”功能 之 外 , 在 其 他 DApp 中 还 存在 很 多 需要 在 服务 器 端 实现 交易 的 情况 。 例 如 ， 基 于 
“ERC721” 协 议 标 准 发 布 的 个 体 类 代 币 ， 如 以 太 猫 等 的 转让 (转账 ) 功能 就 是 在 服务 器 端 进行 的 ， 
转让 是 通过 触发 交易 来 实现 的 。 

本 节 我 们 主要 介绍 如 何 使 用 “sendRawTransaction ”接口 来 实现 以 太 坊 交易 功能 。 


5.2.1 以 太 坊 交易 的 原理 


在 实现 交易 函数 之 前 ， 我 们 先 要 了 解 以 太 坊 整个 交易 的 流程 : 客户 端 签名 交易 、 发 起 交易 数 
据 到 以 太 坊 节点 、 服务 器 端 对 交易 数据 的 校 验 以 及 最 终 交 易 被 添加 到 订单 池 的 交易 队列 。 下 面 我 们 
通过 这 个 流程 对 交易 的 原理 进行 讲解 。 

1. 发 送 数据 

第 一 步 ， 从 参数 组 装 到 发 送 给 以 太 坊 节 点 ， 这 个 过 程 需 要 对 参数 进行 私 钥 签 名 。 这 个 私 钥 的 
提供 者 对 应 传 参 中 的 “ffom” 地 址 用 户 ， 私 钥 签名 图 数 在 “go-ethereum ”源码 中 的 “keystore.go” 
文件 已 提供 了 ， 如 图 5-6 所 示 。 其 中 ，“*#types.Transaction ”就 是 待 签名 的 交易 数据 结构 体 。 


atekey)j 


© » walletRefreshCyde: Dura ; 
ErrLocked: error 270 
v. è Er NoMatch: error 271 fun nc c (ks -keystor celi a accou a Accou "t, tx opes Tra nsaction, chainID *big.Int) (*types.Transaction, error 
V o ErDecrypt: eror 2/2 LooR up the 
V» KeyStoreType- Type 273 pni mu; RLock() 


V. Keystorescheme: string fer ks.mu.RUnlock() 
T.  KeysStore 
Fo» storage: keyStore 
cache: *accountCache 
F 5 changes: chan struct( 
unlocked: map[comim 750 on the p 
wallets: [accounts Ws if pr 2 nil { 
P è updateFeed: event.Fe retur a types s.SignTx(tx, types.NewEIP155Signer(chainID), lunloc 
P è updateScope- event.S m b Ki 


P è updating: bool | n types.SignTx(tx, types.HomesteadSigner{}, | unlockedKey .Privatekey] | unlockedKey .Privatekey] vateKey —-— 


Foo mu: sync RWMutex 


5-6 URH Go 版 本 源码 中 签名 交易 的 函数 
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签名 成 功 后 ， 将 会 对 交易 结构 体 〈 见 图 5-7) 中 的 “V”“S”“R”3 个 字段 进行 赋值 ， 生 成 
的 签名 数据 也 是 由 它们 存储 的 ， 在 交易 被 提交 到 了 节点 后 ， 节 点 的 “ 验 签 ”阶段 ， 也 是 根据 这 3 个 
字段 进行 的 。 


ef type txdata struct ( 
AccountNonce uint64 'j :"nonce" gencodec: "required" 
Price *big.Int `j :"gasPrice" gencodec:"required™ 
GasLimit uint64 `j :"gas" gencodec: "required" 
Recipient *common.Address 'j :"to" rlp:"nil'"^ // nil means contract creation 
Amount *big.Int `j ;"value" gencodec:"required'" 
Payload [ ]byte `j :"input" gencodec:"required"" 


// Signature values 
V *big.Int ^json:"v" gencodec:"required"^ . PR MS 
R *big.Int 'json:"r" gencodec: "required"' 签名 时 候 进 行 赋 值 的 三 个 重要 字段 


S *big.Int 'json:"s" gencodec:"required"^ 


// This is only used when marshaling to JSON. 
Hash *common.Hash 'json:"hash" rlp:"-" 


5-7 ”以 太 坊 Go 版 本 源码 中 的 txdata 结构 体 


第 二 步 ， 将 签 好 名 的 结构 体 数 据 进 行 “RLP 序列 化 ”操作 。 同 样 地 ， 这 个 操作 所 要 使 用 的 函 
数 在 “go-ethereum ”源码 中 也 提供 了 , 对 应 于 “rp ” 依 顿 包 下 “encode.go ”文件 的 “EncodeToBytes” 
国 数 ， 如 图 5-8 所 示 。 其 中 的 “val” 参 数 是 一 个 泛 型 ， 在 当前 的 情况 中 ， 它 是 签 好 名 的 结构 体 。 


—|go-ethereum | -rlp | * encode.go 
Structure Dx - Š apigo *  $ keystore.go > | 9 encode.go | 
94 
95 /f EncodeToBytes returns the RLP encoding of vaL. 
sizebuf: []byte 96 // PI c documentation of Encode for the encoding rules. 
reset() 9 func EncodeToByte val interface()) ([]byte, error) ( 
Write(b []byte) (int, er 55 eb := encbufPool.Ge (*encbuf) 
encode(val interface] 99 defer encbufPool.Put(eb 

Zx mr ELTE PT AA TIED EM, 
encodeStringHeader(| 1 eb.reset() val 入 参 晚 证 我 们 釜 名 好 的 结构 体 
encodesString(b [byte 19 if err := eb.encode(val); err != nil { 
list) *listhead 10; return nil, err 


listEnd(Ih *listhead) | 193 } , 
sizeQ int return eb.toBytes(), nil 


toBytes() []byte 


m. 1:Project 


500000000202!" 


5-8 ”以 太 坊 Go 版 本 源码 中 的 RLP 序列 化 函数 


“RLP “递归 长 度 前 级 〉) ”是 一 种 编码 方式 ， 提 供 了 一 种 适用 于 任意 二 进 制 数 据 数组 的 编码 ， 
已 经 成 为 以 太 坊 中 对 对 象 进行 序列 化 的 主要 编码 方式 。RLP 的 唯一 目标 是 解决 结构 体 的 编码 问题 ， 
对 基本 数据 类 型 〈 比 如 字符 串 、 整 数 型 、 浮 点 型 ) 的 编码 则 交 给 更 高 层 的 协议 处 理 ， 以 太 坊 中 要 求 
数字 必须 是 一 个 大 端 字 节 序 的 〈Big-Endian) 、 没 有 零 占 位 的 存储 格式 。 例 如 ，“ 汉 ”这 个 字 的 
Unicode 编码 是 6C49， 在 存储 的 时 候 ， 如 果 将 6C 放 在 前 面 ，49 放 在 后 面 ， 就 是 大 端 字 节 序 ， 因 为 
6C 的 十 进 制 形 式 比 49 的 十 进 制 要 大 。 没 有 零 占 位 就 是 不 出 现 0 位 。 例 如，6C049 4 — T E. SL 
WERA F TICK. 

关于 “RLP” 编 码 ， 这 里 有 一 篇 很 好 的 文章 可 以 参考 : 

https://segmentfault.com/a/1 190000011763339 
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2. 解读 数据 
上 述 签 名 并 进行 “RLP” 编 码 之 后 的 数据 , 将 会 被 发 送 到 以 太 坊 的 节点 程序 中 。 在 节点 程序 中 ， 

会 对 每 一 笔 提 交 过 来 的 交易 进行 数据 的 一 系列 校 验 。 整 个 校 验 分 为 有 3 个 步骤 : RLP 反 序 列 化 、 
参数 校 验 和 订单 池 相 关 的 判断 。 

(DD RLP 反 序列 化 

第 一 步 ， 将 接收 到 的 校 验 数据 ， 进 行 “RLP 反 序 列 化 ”操作 ， 可 以 使 用 “go-ethereum” 源 公 
中 “rlp” 依 赖 包 下 “decode.go” 文 件 中 的 “DecodeBytes ”函数 来 进行 。 如 图 5-9 所 示 。 


Structure Lo - į- | 8 api.go a decode.go ~ E ü backend.go > | * api backend.go - | * tx poolgo x X keystorego *  * encode.go > 
71 recur SiBncuJ 


mM SUUNMLLI!IGIIOGCLIUIT(CULA, SeUy 


d 


` 


S 


&jems 1232 } 
€ a defaultGasPrice: untyped 1233 


w 网 5 PublicFthereumAPI // SendRawTransaction will add the signed transaction to the transaction pooL. 


b: Backend 35 // The sender is responsible for signing the transaction and using the correct rm 
GasPrice(ctx context.( 1236 func (s *PublicTransactionPoolAPI)| SendRawTransaction(ctx context.Context, encod 


f 
m 
@ + ProtocolVersiono) hex 123 := new types Transaction — | i 
" 1238 i rem " T = ni 
D '« Syndngo (nterface 5. etu A EROR FEE ia PT X EOM err inh 
PublicTxPoolAPI = } RLP 反 序列 化 

b: Backend Ja return submitTransaction(ctx, s.b, tx) 

Content() mapl[string] 1 24; 


Status() map[string]ht 4 243 


9 decode.go * keystore.go = | * encode.go = 


// DecodeBytes parses RLP data from b into val. 
// Please see the documentation of Decode for the decoding rules. 


defaultGasPrice: untyped `> 


PublicEthereumAPI ] // The input must contain exactly one value and no trailing data. 
b: Backend 136 func|DecodeBytes[b []byte, val interface()) error ( 


// TODO: this could use a Stream from a pool. 
protocolVersion0 h 38 r := bytes.NewReader (b) 
As ud iei P 139 if err := NewStream(r, uinte4(len(b))).Decode(val); err !- nil { 
yncing( (interface! . ... " he 
PublicTxPoolAPI . ; return err A b 就 是 传 过 来 的 交易 字 节 流 数 据 
入 参 val 就 是 要 把 反 序 列 化 后 TAL deut 5 
| b: Backend PEE 是 要 把 反 序列 化 后 的 数据 装载 进 的 结构 体 


GasPrice[ctx context.( ; ] 


Content() map[string] 4- 

Status() map[string]hi 1- 

Inspect() map[string]t < 
T. è PublicAccountAPI 


return ErrMoreThanOneValue 


} 


return nil 


5-9 ”以 太 坊 Go 版 本 源码 中 的 交易 接收 接口 函数 和 RLP 反 序列 化 函数 


(2) 参数 校 验 


第 二 步 ， 对 “RLP 反 序 列 化 ”后 恢复 的 交易 数据 进行 校 验 。 校 验 又 分 两 部 分 : 第 一 部 分 是 基 


础 数据 的 校 验 ， 例 如 燃料 费 “Gas” 不 能 太 低 等 ， 第 二 部 分 是 对 “V”“S”“R” 的 签名 校 验 。 


e 数据 的 基础 校 验 , 主要 是 一 些 范 
攻击 、“Gas” 值 不 能 超过 当前 节 


包围 限制 及 格式 限制 校 验 ， 包含 数据 量 不 能 太 大 、 防 止 “DDos” 
点 所 设 的 最 大 值 和 “Nonce” 值 不 能 比 已 经 成 功 过 交易 的 序 


列 值 还 低 和 等， 如 图 5-10 所 示 。 Pe 工作 在 函数 “validateTx” 中 进行 
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Structure S apigo x | $ .go ”| 8 tx pool.go * keystore.go - | * encode.go > 


4d | a/u 二 去 | ai // vaLidateTx checks whether a transaction is valid according to the conse 
3 chainHeadChansSize: unt // rules and adheres to some heuristic Limits of the Local node (price and 

€ mm TxStatusUnknown: TxSta ) func (pool *TxPool)| validateTx(tx *types.Transaction, local bool) error ( 
€ ù TxStatusQueued: TxStatu 566 // Heuristic Limit, reject transactions over 32KB to prevent DOS attach 


m! 1:Project 


yi». d 


. TxStatusPending: TxStatl ^^ // ØE ddos X 


. TxStatusIncluded: TxStat if tx.Size() > 32*1824 ( 检查 数据 量 
return ErrOversizedData T m 


. ErrinvalidSender: error 
. ErrNonceTooLow: error 


) 


// Transactions can't be negative. This may never happen using RLP deca 
66 // transactions but may occur if you create a transaction using the RPO 

FrrReplaceUnderpriced: ¢ ce- if tx.Value().Sign() < © { 

' ErrinsufficientFunds: errd 56 return ErrNegativeValue 

ErrIntrinsicGas: error 59 } 

ErrGasLimit: error // Ensure the transaction doesn't exceed the current block Limit gas. 

ErrNegativeValue: error if pool.currentMaxGas « tx.Gas "-— l 

S error 7 perius ErrGasLimit SUE 检查 gas ÉTDERDACATE 


ErrUnderpriced: error 


statsReportinterval: Dura. ^ ^ // Mahe sure the transaction is signed properly 
from, err ;= types.Sender(pool.signer, tx) 

if err l= nil { 

return ErrInvalidSender 


pendingDiscardCounter: 
3 pendingReplaceCounter: 
pendingRatelimitCounte 


) 


// Drop non-Local transactions under our own minimal accepted gas pricd 
local = local || pool.locals.contains(from) // account may be Local eve 
3 queuedReplaceCounter: if !local && pool.gasPrice.Cmp(tx.GasPrice()) > 89 ( 

: queuedRatelimitCountei return ErrUnderpriced 

i queuedNofundsCounter ) 


3 invalidTx«Counter: Counti í // Ensure the transaction adheres to nonce ordering 
underpricedTxCounter: if pool.currentState.GetNonce(from) » tx.Nonce 


5-10 ”数据 的 基础 校 验 


在 基础 数据 校 验 阶段 ， 会 抛 出 以 太 坊 交易 的 常见 错误 信息 ， 如 果 发 现 有 错误 信息 返回 ， 就 可 
以 到 对 应 的 检测 代码 行进 行 排查 。 营 见 的 以 太 坊 交易 错误 信息 如 图 5-11 所 示 。 


go-ethereum —— core * tx pool.go 
| 8 api.go > | * decode.go > | * backend.go =  * api backend.go > | 8 tx pooloo > ï transaction signing.go = | * signature cgo.go 


3 pendingNofundsCountet 
; queuedDiscardCounter: | 


c 
c 
wv 
V 
v 
v 
v 
v 
V 
v 
v 
v 5 evictionInterval: Duration  ^' } 
v 
V 
v 
V 
v 
v 
v 
v 
v 
v 
v 


a 1:Project 


// ErrinvalidSender 15 returned 1 
ErrInvalidSender = errors.New( text. "invalid sender") 


// ErrNonceTooLlow is returned if the nonce of a transaction is Lower than the 
// one present in the Local chain. 
ErrNonceTooLow = errors.New( text "nonce too low") 


// ErrUnderpriced is returned if a transaction's gas price is below the minimum 
// configured for the transaction pool. 
ErrUnderpriced - errors.New( text "transaction underpriced") 


// ErrRepLaceUnderpriced is returned if a transaction is attempted to be replaced 
// with a different one without the required price bump. 
ErrReplaceUnderpriced = errors.New( text "replacement transaction underpriced") 


// ErrInsufficientFunds is returned if the total cost of executing a transaction 

// is higher than the balance of the user's account. 

ErrInsufficientFunds = errors.New( text "insufficient funds for gas * price + value']) 
// ErrIntrinsicGas is returned if the transaction is specified to use Less gas 

// than reguired to start the invocation. 

ErrIntrinsicGas = errors.New( text "intrinsic gas too low") 

// ErrGasLimit is returned if a transaction's requested gas limit exceeds the 


// maximum aLLowance of the current block. 
ErrGasLimit = errors.New( text "exceeds block gas limit") 


图 5-11 以 太 坊 交易 校 验 阶段 的 常见 错误 


e 签名 信息 的 校 验 。 这 里 所 使 用 的 是 椭圆 曲线 算法 “ secp256k1” 提 供 的 方法 ， 椭 圆 曲 线 算法 
“secp256k1” 支 持 根 据 私 钥 导 出 公 钥 。 对 应 的 校 验 流程 如 图 5-12 所 示 ， 在 “validateTx” 函 
数 内 的 “types.Sender” 开 始 签名 的 校 验 。 
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go-ethereum | core  * tx pool.go | 
* backend.go x  * api backend.go x | 8 tx poolgo =|| 8 transaction signing.go x | 8 signat 


// validateTx checks whether a transaction is valid according to the consensus 
// rules and adheres tg some heuristic Limits of the Local node (price and size) 
func (pool *TxPool) mA *types.Transaction, local bool) error ( 
// Heuristic limit, reject transactions over 32KB to prevent DOS attacks 
// brit ddos if 
if tx.Size() » 32*1024 ( 
return ErrOversizedData 


Transactions can't be negative. This may never happen using RLP decoded 
/^ transactions but may occur if you create a transaction using the RPC. 


tx.Value().Sign() « e ( 
return ErrNegativeValue 


Ensure the transaction doesn't exceed the current block Limit gas. 
pool.currentMaxGas < tx.Gas() { 
return ErrGasLimit 


// Make sure the transaction is signed properly 

from, err := types.Sender(pool.signer, tx) "T AA 
3 . 3 j > AZ re > 

if err != nil { 进入 签名 的 校 验 
return ErrinvalidSender 


d 5-12  validateTx RN 内 调用 types.Sender 函数 进行 交易 的 校 验 


“types.Sender” 畏 数 的 机 制 是 先 从 绥 存 中 检测 ， 判 断 缓 存 中 是 否 已 经 存在 相同 的 签名 信息 ， 
如 图 5-13 所 示 。 如 果 存 在 记录 ， 就 会 直接 返回 校 验 结果 。 如 果 不 存 在 ， 就 会 走 完整 的 校 验 流程 。 
绥 存 机 制 避 免 了 重复 操作 ， 能 在 一 定 程度 上 提高 代码 的 执行 效率 。 


| go-ethereum ` - core  - types ` * transaction signing.go 


9 decode.go x  * backendgo x 9 api backend.go x | Ẹ tx pool.go x | 9 transaction signing.go | signat 


// Sender returns the address derived from the signature (V, R, S) using secp256k1 
elliptic curve and an error if it failed deriving or upon an incorrect 
// signature. 


// Sender may cache the address, allowing it to be used regardless of 
// signing method. The cache is invalidated if the cached signer does 
// not match the signer used in the current call. 
func Sender(signer Signer, tx *Transaction) (common.Address, error) ( 
if sc := tx.from.Load(); sc != nil { 

sigCache :- sc.(sigCache) 

// If the signer used to derive from in a previous 

// caLL is not the same as used current, invalidate 

/ the cache. 
if sigCache.signer.Equal(signer) { 
return sigCache.from, nil 


) 


) 
addr, err := signer.Sender(tx) 进入 此 处 


err iz ni 
return common.Address(), err 
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tx.from.Store(sigCache([signer: signer, from: addr}) 
return addr, nil 


) DO co 


5-13. types.Sender 函数 内 部 的 实现 代码 


在 “recoverPlain ”函数 中 将 会 先 由 “S”“V”“R”3 个 参数 组 合成 签名 信息 ， 然 后 由 
“crypto.Ecrecover ”恢复 出 私 钥 对 应 的 公 钥 ， 最 后 由 公 钥 得 出 地 址 ， 如 图 5-14 所 示 。 
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go-ethereum core ^ types ^ transaction signing.go 
$ api.go | * decode.go | * backend.go > | 和 api backend.go | $ tx pool.go B transaction signing.go 


EN 


var big8 = big.NewInt( x 8) 


126 
127; @t  func|(s EIPi55Signer) Sender(Kx *Transaction) (common.Address, error) { 
28 l£x.Protected 


return HomesteadSigner().Sender(tx) 


] 
if tx. Chaintd(). Cmp(s.chainId) l= e { 
// MEAM s.chainId = EEN HT chanId 
return common .Address{}, ErrInvalidcheinId 
} 
V := new(big.Int).Sub(tx.data.V, s.chainIdMul) 
V.Sub(V, big8) 传 入 S V R 三 参数 
// A recoverPLain 


return |recoverPlain [recoverPlain|s. Hash(tx),|tx. tx.data.R, tx.data.S, V, R, tx.data.S, V,| homestead: true) 


* transaction signing.go 


Š api.go & tx pool.go 8 transaction signing.go * signature cgo.go x | X secp256.go ~ | X crypto. go | * encode.go 


TECATTT | CCUVTIT LGAII(VT2.FlIG2II(VCAJ, CA.UGUOG.IN, CA.UOGLO.J, CA UGL. Vy 


func recoverPlain(sighash common.Hash, R, S, Vb *big.Int, homestead bool) (common.Address 
if Vb.BitLen() » 8 ( 
return common.Address(), ErrInvalidSig 


V := byte(Vb.Uinte4() - 27) 

if !crypto.ValidateSignatureValues(V, R, S, homestead) ( // ^'^ 
return common.Address(), ErrInvalidSig 

} 

// encode the snature in uncompressed format 

r, S :- R.Bytes(), S.Bytes() 

sig := make([]byte, 65) 

copy(sig[32-1en(r):32], r) 

copy(sig[64-len(s):64], s) 


// recover the public key from the snature 
pub, err := crypto.Ecrecover(sighash[:], sig) 


return common.Address(), err 


} 
if len(pub) == 8 || pub[0] != 4 ( 
return common.Address(), errors.New( text: "invalid public key") 


var addr common.Address AME b Mb 
copy(addr[:], crypto.Keccak256(pub[1:])[12:]) HAH pub 得 出 地 


return adar, ni 


R 5-14 验 签 过 程 的 函数 调用 


* crypto.Ecrecover" p ZitrP if] * secp256kl.RecoverPubkey " Jb Ze A [o3] 曲线 算法 恢复 公 钥 的 实例 


该 函数 调用 了 基于 “C 语言 ”的 椭圆 曲线 算法 实现 库 中 的 “secp256kl_ext_ecdsa_ recover" 


函数 ， 最 终 达 到 恢复 的 目的 ， 如 图 5-15 所 示 。 


-go-ethereum |  crypto  * signature cgo.go 


& api.go | & tx pool.go x | 9 transaction signing.go > | 9 signature cgo.go | * secp256.go * | * crypto.go > 
U sse 


// Ecrecover returns the uncompressed pubLic key that created the given signa 


func Ecrecover(hash, E TITT [ash error) { 
return secp256k1.|RecoverPubkey(hash, sig) recover 恢复 ，pubkey 44H 


图 $-15 验 签 操作 最 终 所 调用 的 函数 


(3) 订单 池 相 关 的 判断 
最 后 一 步 是 订单 池 相 关 的 判断 。 这 个 校 验 过 程 分 为 两 个 小 步骤 , 其 中 涉及 的 订单 队列 (Queue) 


和 等 竺 列表 〈Pending) 都 是 订单 池 中 的 组 成 者 成 员 。 在 以 太 坊 “Go” 版 本 的 源码 中 ， 它 们 对 应 的 
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数据 结构 是 “Map”。 


CD 判读 订单 池 订 单 队列 《Queue) 是 否 已 满 ， 因 为 订单 池 的 队列 是 可 以 被 设置 长 度 的 ， 在 订 
单 队 列 满 了 的 情况 下 ,以太 坊 会 将 新 进来 的 交易 订单 和 队列 中 燃料 费 最 低 的 一 笔 交 易 进行 比较 , 然 
后 将 燃料 费 最 低 的 一 笔 交 易 从 订单 池 移 出 并 抛弃 。 

由 这 一 点 我 们 可 以 知道 ， 以 太 坊 的 订单 池 订 单 队 列 中 的 交易 是 根据 燃料 费 高 低 ， 按 照 从 高 到 
低 的 顺序 排队 的 , 处 于 队 尾 的 订单 容易 被 抛弃 。 当 以 太 坊 拥堵 的 时 候 ， 如 果 新 交易 所 设置 的 燃料 费 
不 够 高 ， 可 能 连 排 队 的 队列 都 不 能 进入 。 

图 5-16 所 示 是 上 述 过 程 的 大 致 流程 图 。 


新 交易 
节点 订单 池 
交易 2 
根据 Gas 从 
mecum 
订单 油 队 列 
交易 4 
交易 5 
是 否 队 满 ? 
No 
No - 一 
进入 下 一 步 判 断 返回 错误 
underpriced 
给 客户 端 


18 N 移出 
订单 队列 


5-16 ”交易 在 订单 池 队 列 要 经 历 的 流程 


对 应 的 判断 代码 以 及 每 个 细节 的 注释 已 经 在 图 5-17 中 给 出 。 

D 新 交易 订单 是 否 已 经 在 “pending” (SFREE) 列表 中 。 以 太 坊 的 “pending” 列 表 是 
用 来 存储 那些 已 经 从 交易 队列 中 被 取出 的 交易 项 , 这些 交易 是 区 块 打包 的 候选 交易 。 因 为 位 于 等 待 
列表 的 交易 处 于 等 竺 状态， 它们 有 可 能 会 被 重新 提交 过 来 ,对 于 被 重新 提交 过 来 的 交易 ， 以 太 坊 的 
做 法 是 将 刚 提交 的 和 已 经 存在 的 交易 的 燃料 费 进 行 比较 ， 如 果 新 交易 的 燃料 费 比 旧 交 易 的 燃料 费 
高 ， 就 进行 蔡 换 ， 如 果 不 高 ， 就 返回 错误 给 客户 端 。 默 认 的 燃料 费 蔡 换 规则 是 : 新 交易 的 燃料 费 要 
比 旧 交易 的 燃料 费 大 于 或 等 于 110% 才 可 替换 。 
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go-ethereum  - core  * tx pool.go 
& api.go 8 tx pool.go & tx listgo x | € transaction signing.go x | € signature cgo.go F secp256.9o > | * crypto.go x  $ encode.ga 
? **" c't r= BpVULIUBALAIWOGULTI^ALUA, OCE; vC r= "Hz li 
log.Trace( msg: "Discarding invalid transaction", ctx "hash", hash, "err", err) 


invalidTxCounter.Inc(1) 
return false, err 


// If the transaction pool is full, discard Anderpriced transactions 
AAA | tx HX Eger. CUP tx AM SP. TÆ pending jJ 
di pool. priced E Lii di pool £ iig. RAE OESE zh tx HU m. "OE CUR tx KA 
// pool .price.all, J pool.all Htut —f F 
if uint64(pool. NE: Count) >z qus: config. GlobalSlotsepool. config.GlobalQueue { 
// T£ *he , p— 1. 
gas 价格 判断 
GELA tx LHE. BEA NI ar price 


/ (m 1 p "n t bh ara 1 PA PA ) ye "n" ba E: ^l TT f ANB S T ie, poo „all £ | 
log.Trace( msg: -olscarding na transaction" , ctx "hash", kasih, "price", pe GasPri 


underpricedTxCoun n 
return false, ErrUnderpeicad 新 交易 的 gas PHB, RERNE A 


// New transaction is better than our worse ones, make room for it 


(aLL.Count == GlobalSlots + GlobalQueue yd / / 
A = int(pool.config. GLobalSLots*pooL. config. GLobalQueue-1) 
/1 pool.alL.Count()- A 2 1 Jr EAER 
drop ;= pool.priced.Discard( 
pool.all.Count()-int(pool.config.GlobalSlots*pool.config.GlobalQueue-1), 
poai Tocata) 移 除 队列 最 后 的 交易 
., tx := range drop 1 
log.Trace( msg: "Discarding freshly underpriced transaction", ctx "hash",|tx.Hash(), "prid 
underpricedTxCounter.Inc(1) 
pool.removeTx(tx.Hash(), outofbound: false) 


图 5-17 订单 池 队 列 中 对 新 交易 入 队 前 的 判断 源码 
5-18 是 上 述 第 多 点 对 应 的 大 致 流程 图 。 


新 交易 


新 交易 是 否 已 存在 
等 待 列 表 中 ? 


Yes 


返回 错误 
No 


新 交易 的 油 费 
否 比 已 存在 的 高 ? 


underpriced 


给 客户 端 


No 


添加 进 订单 队列 


5-18 ”新 交易 进入 到 pending 等 待 列表 时 的 流程 
对 应 的 判断 代码 如 下 ， 每 个 细节 的 注释 已 经 在 图 中 给 出 。 
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判断 一 笔 交 易 是 否 已 经 处 于 当前 节点 的 “pending” 等 待 列表 的 两 个 条 件 是 : 


当前 交易 发 送 者 “from” 已 经 在 节点 程序 中 并 有 其 对 应 的 “pending” 等 待 列表 。 
e 当前 交易 发 送 者 “from” 的 等 待 列 表 中 有 和 当前 新 交易 相同 “nonce” 序 列 号 的 交易 。 


图 5-19 所 示 是 pending 等 竺 列表 添加 交易 的 流程 源码 。 


go-ethereum Wi core = tx pool.go 
€ txpoolgo S eventsgo x X txlistgo x | * transaction signing.go x | 9 signature cgo.go > 
SIT 2 | * [ ] Match Case | | Words [ | Regex 
// If the transaction is replacing an already pending one, do directiy 


from, _ := types.Sender(pool.signer, tx) // already validated 
if list :-|pool.pending[from]; |]list !- nil && list.Overlaps(tx) ( 
根据 发 送 者 地 址 from 来 查询 出 该 地 址 的 交易 等 待 列表 


// Nonce already pending, check if required price bump is met 
// pending 47 
inserted, old :- // PriceBump HUH 
if !inserted { : 
pendingDiscardCounter.Inc(1) 找 出 nonce 相同 的 上 一 条 交易 
return false, ErrReplaceUnderpriced 


} 

// New transaction is better, replace old one 

if old != nil { 
pool.all.Remove(old.Hash()) 
pool.priced.Removed() 
pendingReplaceCounter.Inc(1) SÉ gas (IRAE E 


} 

pool.all.Add(tx) 
pool.priced.Put(tx) 
pool.journalTx(from, tx) 


log.Trace( msg: "Pooled new executable transaction", ctx: "hash", hash, 


// We've directly injected a replacement transaction, notify subsystems 
go pool.txFeed.Send(NewTxsEvent( Txs: types.Transactions[tx])) 


return old !- nil, nil 


添加 到 交易 的 队列 


nding one, push into queue 


go-ethereum | core  * tx list.go 


€ apigo x | € tx pool.go x | € events.go x || $ tx list.go € transaction signing.go * | X signature cgo.go = | 3 secp256.go x 


// If the new transaction is accepted into the List, the Lists’ cost and gas 

// thresholds are also potentially updated. 

func (1 ee arat Meier Transaction, priceBump uint64) (bool, *types.Transaction 
"4 ere : etter transaction, abort 


根据 nonce 去 取出 


"threshold := new(big.Int).Div(new(big.Int).Mul(old.GasPrice(), big.NewInt(100*i 
// Have to ensure that the new gas price is higher than the old gas 
// price as well as checking the percentage threshold to ensure that 
// this is accurate for Low (Wei-Level) gas price replacements 
if old.GasPrice().Cmp(tx.GasPrice()) >= 8 || threshold.Cmp(tx.GasPrice()) > e ( 
return false, nil 
} 
} 


// Otherwise overwrite the old transaction with the current one 
l.txs.Put(tx) // UFV SI 
if cost :- tx. Idi l.costcap.Cmp(cost) « e ( 
l.costcap = cost 
} 
if gas := tx.Gas(); l.gascap < gas { 
l.gascap = gas 


fo ho Jo ^ NS ho ^ WW ^N 
OD no oo J 


ww ™.) ^) - 


return true, old 


A 


5-19 pending 等 待 列表 添加 交易 的 流程 源码 


(4) 解答 
在 结束 交易 订单 池 的 两 个 判断 后 ， 如 果 当 前 交易 是 全 新 的 ， 就 将 顺利 地 通过 代码 行 
“pool.enqueueTx(hash, tt) ”， 被 添加 到 节点 程序 的 订单 池 交 易 队 列 中 ， 等 待 被 添加 到 “pending” 
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列表 中 ， 再 被 从 “pending” 列 表 取 出 然后 广播 出 去 。 
在 这 个 过 程 中 ， 请 注意 以 下 两 个 要 点 : 
e 处 于 “pending” 等 待 状态 的 交易 ， 如 果 有 相同 的 “nonce” 序 列 号 ， 就 会 引发 节点 程序 对 它 
们 做 进一步 的 判断 ， 然 后 选择 出 燃料 费 最 高 的 ， 替 换 掉 燃料 费 低 的 。 
e 节点 “ 挂 ” 掉 了 ( 断 网 了 或 者 宕 机 了 ) ， 还 没 被 处 理 的 交易 就 会 丢失 。 当 交易 还 在 交易 队列 
时 且 还 没 被 广播 出 去 ， 这 时 节点 程序 “ 挂 ” 了 ， 存 放 在 内 存 的 数据 就 丢失 了 。 


还 需要 注意 的 是 ， 对 于 “sendTransaction” 接 口 而 言 ， 因 为 它 本 身 是 在 节点 程序 中 直接 执行 ， 
而 非 被 远程 调用 执行 , 相当 于 用 户 在 控制 台 直 接 执行 控制 台 交 易 命 令 , 这 类 直接 在 控制 台中 发 起 的 
交易 被 称 为 本 地 交易 ， 即 “local Tx" . 

相 比 于 远程 交易 ， 本 地 的 交易 具有 更 高 的 权限 ， 这 种 权限 体现 在 下 面 几 点 : 


o 不 轻易 被 替换 
@ 在 尚未 被 移 除 的 时 候 ， 会 被 持久 化 地 存储 于 本 地 一 个 文件 中 。 
e 在 节点 启动 进行 交易 数据 恢复 的 时 候 ， 优 先 从 本 地 加 载 到 本 地 交易 。 


本 地 交易 在 “发 送 数据 ”阶段 的 数据 签名 ， 将 直接 由 当前 在 节点 程序 中 解锁 了 的 账户 提供 私 
钥 进行 签名 ， 不 需要 我 们 编写 代码 进行 签名 。 同 时 ， 也 不 需要 进行 “RLP 序列 化 ”。 在 “解读 数 
据 ” 阶 段 ， 也 没有 “RLP 反 序 列 化 ”操作 。 

此 外 , 对 于 订单 池 中 处 于 “pending ”列表 的 交易 在 被 打包 进 区 块 中 的 时 候 , 还 没 被 从 “pending” 
列表 中 移 除 ， 只 有 这 个 区 块 成 为 合法 区 块 后 ， 区 块 中 打包 了 的 交易 才 会 被 从 交易 池 中 移 除 掉 ， 如 果 
交易 被 写 进 了 分 又 块 ， 交 易 池 中 的 交易 也 不 会 减少 ， 而 是 等 待 重新 打包 。 


5.2.2 以太 坊 ETH 的 交易 


本 节 我 们 来 介绍 调用 以 太 坊 ETH 交易 接口 函数 的 操作 流程 。 

1. 解锁 钱包 

在 实现 对 交易 数据 进行 签名 之 前 ， 要 先 对 当前 交易 中 作为 交易 发 起 者 的 地 址 进行 解锁 操作 o 
所 谓 解锁 ， 就 是 获取 到 地 址 对 应 的 私 钥 。 

解锁 钱包 的 操作 流程 是 ， 将 发 起 地 址 的 “keystore” 文 件 结合 当初 设置 的 密码 解析 出 私 钥 ， 将 
私 钥 数据 放 在 内 存 中 ， 竺 需要 对 数据 进行 签名 的 时 候 使 用 。 

以 前 面 “ 创 建 钱 包 ” 一 节 中 所 创建 的 钱包 “590c3d81b70ddff32f74e51f14805915a4c0e2ed” 为 
例 ， 其 对 应 的 “keystore” 文 件 的 “json” 数 据 如 下 所 示 : 


{"address":"590c3d8 1b70ddff32f74e51f14805915a4c0e2ed","crypto": {"cipher":"aes-128-ctr","ciph 
ertext":"e5e3ca8af03367e4952e4aabb8d88763ef97e243e9ba4d54c3959c3f7389cefa","cipherparams":{"iv 
":"88957de75b94cf4d1d40f0b9153b9d74" },"kdf":"scrypt","kdfparams": {"dklen":32,"n":262144,"p":1,"r" 
:8,"salt":"ace2c 1f8 1d594b9e5f034dd355f968c13e1127fbf2c5f539a7ddecfa7ae2d139"},"mac":"d1 1c4daf4 
204c7280180029feedf5 1b8bfe267eb3c9bb4cdfa9e48d7d937b243" },"id":"a6e843d2-067e-4715-bc7a-85b 
f9d4b8b23","version":3] 
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密码 是 : 

13430aa 

以 太 坊 “go-ethereum ”源码 中 的 “keystore.go” 文 件 同样 也 提供 了 解锁 钱包 的 函数 源 代 码 ， 该 
图 数 名 称 为 Unlock， 记 得 前 面 的 “创建 钱包 ”一 节 中 所 用 到 的 主要 图 数 也 是 来 上 自 于 “keystore.go” 
文件 ， 可 以 说 “keystore.go” 源 码 文件 包含 了 钱包 各 项 操作 的 源码 ， 如 图 5-20 所 示 。 


path src github.com ethereum go-ethereum accounts keystore | keystore.go 
i keystore.go 


— XX 


J 
312 return types.SignTx(tx, types.HomesteadSigner(), key.PrivateKey) 


} 


// UnLock unlocks the given account indefinitely. 
func (ks *KeyStore)|Unlock[a accounts.Account, passphrase string) error { 
return ks.TimedUnlock(a, passphrase, timeout: 0) 


解锁 钱包 


5-20 ”解锁 钱包 函数 的 源 代码 


要 使 用 “keystore.g0” 中 的 “Unlock” 函 数 ， 首 先 要 实例 化 一 个 “KeyStore” 对 和 象 指 针 ， 它 的 
实例 化 步骤 和 创建 钱包 是 一 样 的 ， 实 例 化 的 时 候 需 要 传 入 当初 设置 存储 “keystore ”文件 的 文件 夹 。 
执行 解锁 时 ， 对 应 的 代码 便 会 进入 到 这 个 文件 夹 寻找 对 应 地 址 的 “keystore” 文 件 ， 青 结合 密码 完 
成 解锁 操作 。 

因为 钱包 解锁 函数 不 属于 提供 给 客户 问 接 口 的 类 别 ， 所 以 在 项 目 中 创建 一 个 名 称 为 “tool” 的 
文件 夹 ， 代 表 工 具 集 合 ， 在 该 文件 夹 内 创建 名 为 “wallet.go” 的 文件 ， 如 图 5-21 Br. 


eth-relay tool > $ wallet.go 


Pr» © £x 一 Ẹ walletgo 
1 package tool 


eth-relay D\go 1.9390 
keystores 
model 
tool 
5 wallet.go 
让 ETH RPC Client.go 
E ETH RPC Requester. 
E, ethrpc test.go 


这 main aa 


5-1 创建 wallet.go 文件 
解锁 钱包 的 完整 代码 如 下 ， 笛 要 知道 的 一 点 是 ， 所 解锁 出 的 私 钥 将 会 由 “KeyStore” 实 例 中 的 
变量 存储 。 因 此 在 下 面 代 码 中 需要 一 个 全 局 变量 的 “KeyStore” 实 例 变 量 “UnlockKs” 来 供 程序 使 
用 。 
// 全 局 地 保存 了 已 经 解锁 成 功 的 钱包 map 集合 变量 


var ETHUnlockMap map[string]accounts.Account 


// 全 局 地 对 应 keystore 实例 


var UnlockKs *keystore.KeyStore 


// 解锁 以 太 坊 钱包 ， 传 入 钱包 地 址 和 对 应 的 keystore 密码 
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func UnlockETHWallet(keysDir string,address, password string) error { 
if UnlockKs == nil { 
UnlockKs = keystore.NewKeyStore( 
// 服务 器 端 存 储 keystore 文件 的 文件 夹 
// 这 些 配 置 类 的 信息 可 以 由 配置 文件 指定 
keysDir, 
keystore.StandardScryptN, 
keystore.StandardScryptP) 
if UnlockKs == nil { 
return errors.New("ks is nil") 
} 
} 
unlock := accounts.Account{Address: common.HexToAddress (address)] 
// ks.Unlock 调用 keystore.go 的 解锁 函数 ， 解 锁 出 的 私 钥 将 存储 在 它 里 面 的 变量 中 
if err := UnlockKs.Unlock(unlock, password); nil != err ( 
return errors.New("unlock err: " + err.Error()) 
} 
if ETHUnlockMap == nil { 
ETHUnlockMap = map[string]accounts.Accountí] 
} 
ETHUnlockMap[address] = unlock // 解锁 成 功 ， 存 储 
return nil 


解锁 钱包 的 单元 测试 ， 将 编写 在 与 “toolgo” 同 级 的 测试 文件 中 ， 新 建 “tool test.go" x fF, 
代表 当前 工具 代码 文件 的 测试 文件 。 测 试 代码 如 下 〈 参 考 图 5-22) : 
func Test UnlockETHWallet(t *testing.T) { 
address := "0x590c3d81b70ddff32f74e51f14805915a4c0e2ed" 
keysDir := "../keystores" 


// 第 一 次 演示 密码 错误 的 情况 
errl := UnlockETHWallet(keysDir,address, "789") 


lI BFEI-!-—m mul. 
fmt .Println ("第 一 次 解锁 错误 : ", errl.Error()) 
} else { 


fmt .Println(" 第 一 次 解锁 成 功 !") 
} 
// 第 二 次 密码 正确 ， 解 锁 成 功 
err2 := UnlockETHWallet(keysDir,address, "13456aa") 


if err2 !- nil { 
fmt .Println ("第 二 次 解锁 错误 : ", errl.Error()) 
) else { 


fmt .Println ("第 二 次 解锁 成 功 !") 
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Feth-relay ^ tool 3 
| Projet ~ © 
v eth-relay D\go_1.9\go_path 
> Wkeystores 
> model 


» 


"testing" 


tool ) 


B tool test. 
| func Test UnlockETHWallet(t *testing.T) ( 


8 wallet.go 
E ETH RPC Client.go 


v erri := UnlockETHWallet( address: "0x590c3481b70ddff32f74e51f14805915a4c0e2ed", password: "789") 
E ETH RPC Requester.go if errl != nil { 
zx fmt.Println( a: "第 一 次 解 镇 错误 : ",errl.Error()) 
, ethrpc test.go , 
- ii 3 l jelse( 
E maingo fmt.Println( a. “第 一 次 解 镇 成 功 !”) 


> lll External Libraries } 
> "gScratches and Consoles err2 := UnlockETHWallet( address: "0x590c3481b76ddff32f74051f14805915a4c0e2ed" , password: "13456aa") 
if err2 != nil { 
fmt.Println( a: "第 二 次 解 馈 销 误 : ",errl.Error()) 
jelse( 
fmt.Println( a: "第 二 次 解 镇 成 功 1") 
} 


} 


5-22 ”解锁 钱包 单元 测试 函数 内 的 测试 代码 
运行 结果 如 图 5-23 所 示 。 


+ Test UnlockETHWallet in eth-relay/tool 
© » (9) Tests passed: 1 of 1 test - 2s 74 ms 


<4 go setup í— 


一 次 解锁 错 unlock err : could not decrypt key with given passphrase 
第 二 次 解锁 成 功 


Process finished with exit code 0 


€ 5-23 Test UnlockETHWallet 解锁 钱包 单元 测试 函数 的 运行 结果 
2. 对 数据 进行 签名 
对 数据 进行 签名 所 使 用 的 SignTx 函数 也 是 由 “keystore.go” 源 公文 件 提供 的 ， 如 图 5-24 所 示 。 


— src > Ml github.com > ™ ethereum > ™ go-ethereum > ™ accounts > ™ keystore > keystore.go 
一 Si wallet.go * | Stool test.go * | $i keystore.go 


77 Sign the hash using plain ECDSA operations 


_path\ return crypto.Sign(hash, unlockedKey.PrivateKey) 


// SignTx signs the given transaction with the requested account. 

func (ks *KeyStore) EDS, accounts.Account, tx *types.Transaction, chainID *big.Int) (*types.Transac 
// Look up the key to sign with and abort if it cannot be found 
ks. mu.RLock() AS tx 就 是 交易 信息 结构 体 
defer ks.mu.RUnlock() EM 


unlockedKey, found := ks.unlocked[a.Address] 
if !found ( 

return nil, ErrLocked 
} 


// Depending on the presence of the chain ID, sign with EIP155 or homestead 
if chainID !- nil { 
return types.SignTx(tx, types.NewEIP155Signer(chainID), unlockedKey.PrivateKey) 


return types.SignTx(tx, types.HomesteadSigner(), unlockedKey.PrivateKey) 


5-24 SignTx 函数 的 “keystore.g0” 源 人 码 


“SignTx” 图 数 的 第 一 个 参数 是 传 入 当前 解锁 了 的 钱包 地 址 ， 其 内 部 的 实现 步骤 是 ， 首 先 根 
Eth 再 使 用 私 钥 对 交易 信息 结构 体 签 名 。 第 三 个 参数 默认 传 入 衬 值 即 可 ， 
它 代 表 的 是 节点 的 ID。 
在 “unlockedKey, found := ks.unlocked[a.Address]” 中 ，“ks” 的 “unlocked” 所 保存 的 就 是 已 
经 解锁 了 的 钱包 的 私 钥 。 
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签名 图 数 如 下 ， 其 中 “types.Transaction ”是 源码 定义 好 的 交易 结构 体 ， 里 面 的 每 个 参数 和 变 
量 在 “交易 参数 的 说 明 ” 一 节 中 都 做 过 详细 的 说 明 。 


type txdata struct I 


AccountNonce uint64 `json: "nonce" gencodec:"required"^ // 交易 序列 号 

Price *pig. Int `json:"gasPrice" gencodec:"required".  // gasPrice 

GasLimit uint64 ^]son:"qas" gencodec:"required"'  // gasLimit 

// to 交易 的 接收 者 地 址 ，\nil means contract creation” 的 意思 是 ， 空 意味 着 创建 智能 合约 

Recipient *common.Address '^json:"to" rlp:"nil"^ // nil means contract 
creation 

Amount *big.Int "json: "value" gencodec:"required"^  // 要 交易 的 
代 币 数值 

Payload []byte “json: "input" gencodec:"required"^  // data 参数 


// Signature values 

// FHR v r s 签名 时 会 赋值 ， 其 中 保存 的 是 签名 后 生成 的 数据 
V *big.Int json:"v" gencodec:"required"' 

R *big.Int ^json:"r" gencodec:"required" 

S *big.Int 'json:"s" gencodec:"required"" 


Hash *common.Hash ‘json: "hash" rlp:"-"" 


} 
// 对 交易 数据 结构 体 types .Transaction 进行 签名 


func SignETHTransaction(address string,transaction *types.Transaction) 
(*types.Transaction, error) ( 
if UnlockKs == nil { 
return nil,errors.New("you need to init keystore first!") 
} 
account := ETHUnlockMap[address] 
if !common.IsHexAddress (account.Address.String()) { 
// 判断 当前 的 地 址 钱包 是 否 解锁 了 


return nil,errors.New("account need to unlock first!") 


} 
return UnlockKs.SignTx(account,transaction,nil) // 调用 签名 函数 


在 签名 图 数 的 单元 测试 中 ， 因 为 其 前 置 的 条 件 是 要 先 解锁 钱包 ， 上 所 以 我 们 将 其 放 在 解锁 钱包 
国 数 执行 完 之 后 再 执行 ， 最 终 的 结果 使 用 “json” 的 格式 输出 。 我 们 观察 输出 后 的 “V”“R”“S?” 
变量 是 否 有 值 ， 有 值 则 代表 签名 成 功 。 代 码 如 下 : 


func Test UnlockETHWallet(t *testing.T) { 
address := "0x590c3d81b70ddff32f74e51f14805915a4c0e2ed" 
// 第 一 次 演示 密码 错误 的 情况 
errl := UnlockETHWallet (address,"789") 


if errl !- nil { 
fmt .Println ("第 一 次 解锁 错误 : ",errl.Error()) 
}else{ 


fmt .Println ("第 一 次 解锁 成 功 !") 
} 
// 第 二 次 密码 正确 ， 解 锁 成 功 
err2 := UnlockETHWallet (address,"13456aa") 
if err2 !- nil ( 
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fmt .Println(" 第 二 次 解锁 错误 : ",errl.Error()) 
Jelse( 
fmt .Println ("第 二 次 解锁 成 功 !") 
} 
// 下 面 是 签名 的 测试 
tx := types.NewTransaction(  // 创建 一 个 测试 用 的 交易 数据 结构 体 


193. // nonce 交易 序列 号 
common .Address{}, // to 接收 者 地 址 
new (big.Int).SetInt64(10), // value 数值 
1000, // gasLimit 
new (big.Int).SetInt64(20), // gasPrice 
[]byte (" 交 易 ") ) // data 
signTx,err := SignETHTransaction(address,tx) 
if err !- nil { 
fmt .Printlin ("签名 失败 !", err .Error ()) 
return 


} 


data, := json.Marshal (signTx) 
fmt .Println ("签名 成 功 \n", string (data)) 


} 
运行 结果 如 图 5-25 Pr. 
^. Test UnlockETHWallet in eth-relay/tool 
> © » (Q) Tests passed: 1 of 1 test - 2s 25 ms 
«4 go setup calls» 
第 一 次 解锁 错误 : unlock err : could not decrypt key with given passphrase 
第 二 次 解锁 成 功 ! 
签名 成 功 
("nonce":"0x7b","gasPrice":"0x14", "gas": "0Ox3e8", "to" :"0x00000000000000000000Q 
5-225 ”解锁 钱包 并 对 数据 进行 签名 的 运行 结果 
完整 的 “json” 数 据 如 下 : 
{ 
"nonce"; "O0x'b", 
"gasPrice"; "Oxl4", 
"gas": "0x3e8", 
"Lo": "0x0000000000000000000000000000000000000000", 
"value"; "O0xa", 
"input": "0xe4baa4e69893", 
ra 
"y Ww ° 
"0x79583c15bc3464bb86e3e28aaf13e222025d7ef4744a270d44ce5d9d6e1629f", 
Wow e 
"Ox5accb4bf5c8961b7e2adf922048dqd78da5fe3fd8e8444e62ba441fa793fa519dd", 
"hash"; 
"0xe449560dc61e79203£d5aaca4d197548e670477635834710276a22c5818a£f37£f" 
} 
3. 发 送 交 易 


在 签名 完成 之 后 ， 调 用 以 太 坊 的 “eth_sendRawTransaction ”接口 发 送 交 易 数 据 ， 将 交易 发 送 
到 节点 中 去 。 
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最 后 的 一 步 是 “RLP 序列 化 ”， 根 据 我 们 前 面 “ 发 送 数据 ”一 节 讲 到 的 ， 我 们 知道 该 序列 化 
Zi BER UTE IS "rip" WINE FHJ *encode.go" XLIFF, ERAI ME "EncodeToBytes" . E45 
将 签名 好 的 交易 数据 进行 传 参 调 用 ， 即 可 一 步 到 位 ， 如 图 5-26 Pr. 


// 3E FF rtp IFAI 
txData, err := rlp.EncodeToBytes(tx) 


if nil !- err ( 
return tx, err 


} 


526 ”调用 rip 序列 化 函数 


E “RLP 序列 化 ”后 ， 就 可 以 使 用 “RPC” 客 户 端 请 求 者 向 以 太 坊 节点 进行 “RPC” 请 求 了 ， 
完整 的 交易 图 数 如 下 : 
// 发 送 交 易 ， 根 据 入 参 transaction 的 不 同 变量 设置 ， 达 到 发 送 不 同 种 类 的 交易 
func (r *ETHRPCRequester) SendTransaction(address string,transaction 


*types.Transaction) (string,error) ( 


// 对 交易 数据 进行 签名 


signTx,err := tool.SignETHTransaction (address,transaction) 


if err !- nil { 
return mn, fmt .Errorf (" 签 名 失败 ! $s",err.Error()) 
} 
// rip 序列 化 
txRlpData, err := rlp.EncodeToBytes (signTx) 
if nil !- err { 


return "", fmt.Errorf("rlp 序列 化 失败 ! $s",err.Error()) 


} 
// 下 面 调用 以 太 坊 的 rpc 接口 
txHash := "" 
methodName :- "eth sendRawTransaction" 
err - r.client.client.Call(&txHash,methodName, common.ToHex(txRlpData)) 
if err !- nil { 
return "", fmt.Errorf ("RSX E KW! $s",err.Error()) 
} 
return txHash,nil // 返回 交易 hash 


实现 代码 存放 在 “ETH RPC Requester.go” 文 件 中 ， 之 后 就 可 以 根据 传 入 的 交易 结构 体内 部 
参数 不 同 的 设置 而 达到 发 起 不 同 种 类 的 交易 。 
下 和 面 我 们 根据 上 和 面 完成 的 “SendTransaction” 销 数 来 分 别 封装 实现 以 太 坊 ETH B] EIE S ER 
数 以 及 非 ETH 类 的 代 币 转账 函数 。 
4. nonce 管理 器 
发 起 交易 的 数据 中 需要 传递 “nonce” 序 列 号 参数 ， 而 且 每 笔 新 交易 的 “nonce” 要 求 必 须要 比 
当前 交易 发 起 者 最 近 一 笔 成 功 交 易 的 “nonce” 值 要 大 。 
FHARR “none” KWEH, EATA “Nonce 的 作用 ”一 节 中 的 讲解 。 
(1) 作为 交易 接口 的 参数 。 
(2) 代表 每 次 交易 的 序列 号 ， 方 便 节 点 程序 处 理 被 重复 发 起 的 交易 。 
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(3) 如 果 “nonce” 比 最 近 一 笔 成 功 交 易 的 “nonce” 要 小 ， 转 账 出 错 。 

(4) 如 果 “nonce” 比 最 近 一 笔 成 功 交 易 的 “nonce” 大 了 不 止 1, 那么 这 笔 发 起 的 交易 就 会 
长 久 处 于 队列 之 中 ， 此 时 不 是 等 待 (pending) RA! 在 补 齐 了 此 “nonce” 值 到 最 近 成 功 的 那 笔 交 
易 的 “nonce” 值 之 间 的 “nonce” 值 后 ， 此 笔 交 易 就 可 以 被 执行 。 

(5) 还 处 于 队列 中 的 交易 ， 不 考虑 其 他 节点 缓存 广播 的 情况 下 ， 如 果 此 时 节点 “ 挂 ” 了 ， 那 
么 尚未 被 处 理 的 交易 将 会 丢失 。 

(6) 处 于 pending 等 待 状态 的 交易 ， 如 果 具 有 相同 的 nonce， 就 会 引发 节点 程序 对 它们 进一步 
的 判断 ， 然 后 选择 燃料 费 最 高 的 ， 符 换 反 燃料 费 低 的 。 


因为 “nonce” 在 交易 中 起 到 了 上 述 十 分 重要 的 作用 ， 而 以 太 坊 源码 中 并 没有 帮助 我 们 管理 
“nonce”， 上 所 以 需要 我 们 目 己 实现 一 个 “nonce” 管 理 器 ， 来 计算 当前 交易 发 起 者 发 起 交易 的 时 候 
应 该 将 “nonce” 的 值 设 为 多 少 才 正 确 。 这 就 是 “nonce” 管 理 器 的 主要 作用 。 

实现 “nonce” 管 理 器 主要 使 用 以 太 坊 接口 中 的 “eth getTransactionCount” 接 口 ， 该 接口 的 相 
关 介 绍 见 “重要 接口 的 含义 详解 ”一 节 。 

得 看 以 太 坊 的 “RPC” 接 口 文档 可 知 ，“eth_getTransactionCount” 接 口 需 要 传 入 两 个 参数 : 
第 一 个 是 当前 要 获取 的 “nonce” 的 以 太 坊 地 址 值 ， 在 交易 中 ， 这 个 参数 就 是 交易 发 起 者 的 地 址 ; 
第 二 个 参数 是 区 块 号 参数 ， 该 参数 返回 的 结果 是 一 个 十 六 进 制 的 “nonce” 值 ， 如 图 5-27 所 示 。 


eth getTransactionCount 


Returns the number of transactions sent from an address. 


Parameters 


1. DATA , 20 Bytes - address. 
2. QuaNTITYv|TAG -integer block number, or the string "latest" , "earliest" Or "pending" , see the 


default block parameter 


params: [ 
'0ex407d73d8a49eeb85d32cf465507dd71d507160c1' , 
'latest' state at the latest block 


] 


Returns 


QUANTITY - integer of the number of transactions send from this address. 


Example 


curl -X POST --data '("jsonrpc":"2.0","method":"eth getTransactionCount","params":["0x407d73d8a49e 


5-27 eth getTransactionCount 接口 的 文档 介绍 
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根据 文档 中 提供 的 信息 , 我 们 到 “ETH RPC Requester.go ”文件 中 先 实现 “eth getTransactionCount " 
接口 的 请 求 函数 ， 代 人 码 如 下 : 


// 获取 地 址 的 nonce 值 
func (r *ETHRPCRequester) GetNonce(address string) (uint64,error) { 


methodName := "eth getTransactionCount" // 指定 接口 名 称 
nonce :一 


// 因为 我 们 要 查询 最 新 的 ， 根 据 基于 etTransactionCount 情况 下 的 区 块 号 关系 ， 选 取 pending 

err := r.client.client.Call(&nonce,methodName, address,"pending") 

if err !- nil { 

return 0, fmt.Errorf ("RSX RK! $s",err.Error()) 

} 

n, := new(big.Int).SetString(nonce[2:]1,16) // 采用 大 数 类 型 将 十 六 进 制 的 结果 值 转 为 十 
进 制 的 结果 值 

return n.Uint64(),nil // 返回 交易 的 哈 希 值 
} 


其 中 为 什么 第 二 个 参数 要 选择 “pending”， 原 因 在 “重要 接口 的 含义 详解 ”一 节 讲 解 
“eth getTransactionCount” 接 口 时 已 有 说 明 ， 下 面 再 做 一 点 补充 : 
eth_getTransactionCount 接口 根据 以 太 坊 钱包 地 址 获取 基于 当前 钱包 地 址 的 交易 序列 号 
Nonce。 第 二 个 传 入 的 参数 genesis. pending 和 latest， 分 别 对 应 下 面 的 效果 : 


€ genesis 时 ， 获 取 当 前 以 太 坊 地 址 第 一 次 发 起 交易 时 的 Nonce 序列 号 。 

e 取 pending 时 , 获取 当前 以 太 坊 地 址 提交 的 正 处 于 pending 状态 等 待 被 区 块 打包 的 交易 订单 所 
对 应 的 Nonce 序列 号 。 请 注意 ， 如 果 当 前 所 查询 的 地 址 没有 处 于 pending 的 交易 状态 ， 那 么 
它 将 返回 与 latest 一 样 的 Nonce 5. 

e IK latest 时 ,获取 当前 以 太 坊 地 址 当前 提交 了 且 被 区 块 成 功 打包 了 的 交易 订单 所 对 应 的 Nonce 
序列 号 加 1 的 值 。 举 个 例子 ， 地 址 A 最 后 一 笔 成 功 交 易 对 应 的 Nonce 为 4， 那么 当 调用 接口 
传 入 该 参数 的 时 候 ， 获 取 的 结果 是 5。 


在 eth_getTransactionCount 中 ，Nonce 得 询 满足 : pending = latest — genesis. 
单元 测试 代码 如 下 : 


// 单元 测试 : 获取 nonce 
func Test GetNonce(t *testing.T) { 
nodeUrl := "https://mainnet.infura.io/v3/2e64d9331f£74d472a9d47fe99f697ca2b" 
address := "0x0D0707963952f2fBA59dD06f2b425ace40b492Fe" 
if address == "" || len(address) !- 42 { 
// 这 里 演示 在 调用 rpe 接口 函数 时 要 先进 行 入 参 的 合法 性 判断 
fmt .Println ("非法 的 交易 地 址 值 ") 
return 
} 
nonce,err := NewETHRPCRequester (nodeUrl).GetNonce (address) 
if err !- nil { 
// 碍 询 失 败 ， 打 印 出 信息 
fmt .Println ("查询 nonce 失败 ， 信 息 是 : ",err.Error()) 
return 
} 
fmt.Println (nonce) 
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运行 结果 如 图 5-28 所 示 。 


= Test GetNonce in eth-relay 


© » @ Tests passed: 1 of 1 test- 1s 3 ms 


<4 go setup calls> 
750341 


Process finished with exit code 6 


5-28 Test GetNonce 单元 测试 函数 的 运行 结果 


f£ * GetNonce" eR ZB] Eli E, RAIF UR iR “nonce” Eiro HIRIE, 假设 “nonce” 
值 不 做 “人 硬 ” 存 储 则 不 会 存放 到 数据 库 或 者 文件 中 ， 那 么 在 程序 首次 运行 发 起 交易 时 ， 会 调用 一 次 
“GetNonce” 图 数 ， 从 以 太 坊 节点 网 络 中 获取 当前 合理 的 “nonce” 值 。 当 发 起 了 一 笔 交 易 ， 且 成 
功 获取 了 以 太 坊 节点 返回 的 交易 哈 希 之 后 ， 我 们 就 将 “nonce” 值 进行 加 1 的 操作 ， 并 存放 在 内 存 
中 。 接 下 来 发 起 的 其 他 交易 中 的 “nonce” 值 会 直接 从 内 存 中 获取 出 来 。 当 某 次 交易 发 送 错误 的 时 
候 ， 我 们 再 次 使 用 “GetNonce” 函 数 获取 一 次 节点 中 的 “nonce” 值 ， 重 发 一 次 当前 失败 的 交易 ， 
以 此 循环 。 大 致 流程 图 如 图 5-29 所 示 。 


从 内 存 中 
取 nonce 值 


5-29 nonce 管理 器 的 设计 流程 图 
接 下 来 在 项 目 主 文件 夹 下 创建 一 个 “nonce manager.go” 文 件 ， 用 来 存储 “nonce” 的 管理 实 
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现代 码 ， 如 图 5-30 所 示 。 


eth-relay > * nonce manager.go 


Project © => X 一 # nonce manager.go 


eth-relay D\go 1.950 ps package main 


> keystores 
> model 
> tool 
$* ETH RPC Client.go 
W ETH RPC Requester.go 
9» ethrpc test.go 
是 main.go 


B nonce manager.go 


> Ilii External Libraries 


5-30 ”创建 一 个 “nonce manager.go" Xr 


代码 如 下 : 
// 管理 器 结构 体 


type NonceManager struct { 
// lock 是 互 斥 锁 ，go 的 map 类 型 不 是 协 程 安全 的 ， 
// ERS map 的 时 候 ， 我 们 要 考虑 多 协 程 并 发 的 情况 


lock sync.Mutex 


// 采用 整 型 大 数 来 存储 nonce 


nonceMemCache map[string]*big.Int 
) 


func NewNonceManager() *NonceManager { 
return &NonceManager( 
lock: sync.Mutex(), // 实例 化 互 斥 锁 
} 
} 


// 设置 nonce 
func (n *NonceManager) SetNonce(address string,nonce *big.Int) { 
if n.nonceMemCache == nil { 


n.nonceMemCache = map[string]*big.Intí] 
} 
n.lock.Lock() // 加 锁 
defer n.lock.Unlock() // 当 该 函数 执行 完毕 ， 进 行 解锁 
n.nonceMemCache[address] = nonce 


} 
// 根据 以 太 坊 地 址 获取 nonce 


func (n *NonceManager) GetNonce(address string) *big.Int { 
if n.nonceMemCache == nil { 
n.nonceMemCache = map[string]*big.Intí)] 
} 
n.lock.Lock() // 加 锁 
defer n.lock.Unlock() // 当 该 函数 执行 完毕 ， 进 行 解锁 


return n.nonceMemCache[address] 
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// nonce 进行 加 1 的 操作 


func (n *NonceManager) PlusNonce(address string) { 


if n.nonceMemCache == nil { 
n.nonceMemCache - map[string]*big.Intí] 

] 

n.lock.Lock() // 加 锁 


defer n.lock.Unlock() // 当 该 函数 执行 完毕 ， 进 行 解锁 


oldNonce := n.nonceMemCache [address] 
newNonce := oldNonce.Add(oldNonce, big.NewInt(int64(1))) 
n.nonceMemCache[address] = newNonce 


然后 ， 对 之 前 的 “RPC” 请 求 者 进行 部 分 修改 ， 把 “nonce” 管 理 器 的 对 象 指针 添加 进去 ， 作 
为 请 求 者 的 一 个 变量 , 这 样 在 使 用 请 求 者 交易 图 数 的 时 候 才 能 使 用 对 应 的 管理 器 ,同时 在 请 求 者 初 
始 化 的 时 候 初 始 化 “nonce” 管 理 器 。 修 改 代 码 ， 如 图 5-31 所 示 。 


L6 type ETHRPCRequester struct 
/ nonceManager *NonceManager |// nonce 5/7; SP 


client *ETHRPCClient // DEATH, &hrnpc Br Èi 


func NewETHRPCRequester(nodeUrl string) *ETHRPCRequester { 
uester :- &ETHRPCR 


7 HU 


// EHM nonce SJ7T$; 
requester.nonceManager = NewNonceManager() 
// SUITE rpe ZP Ii 

requester.client = NewETHRPCClient(nodeUrl) 
return requester 


5-31 修改 “RPC” 请 求 者 的 代码 


最 后 在 “发 送 交 易 ” 的 图 数 后 面 ， 加 上 当 交 易 的 “hash” 值 正确 返回 时 当前 发 起 交易 的 地 址 
“nonce” 值 加 1， 这样 才能 确保 在 批量 发 起 交易 的 业务 场景 中 实现 “nonce” 值 的 正确 增加 。 修 改 
代码 如 下 : 
err = r.client.client.Call(&txHash, methodName, common.ToHex(txRlpData)) 
if err !- nil f 
return "", fmt.Errorf (" 发 送 交 易 失 败 ! $s", err.Error()) 


} 
oldNonce := r.nonceManager.GetNonce (address) 


if oldNonce == nil { 
r.nonceManager.SetNonce (address,new(big.Int).SetUint64(transaction.Nonce())) 
} 
r.nonceManager.PlusNonce(address) // 成 功 后 ， 当 前 用 户 内 存 的 nonce 值 加 1 
return txHash, nil // 返回 交易 的 哈 希 值 


下 面 将 按照 图 5-29 的 流程 图 实现 “nonce” 管 理 髓 。 

5. 发 送 ETH 交易 

综合 前面 各 节 的 讲解 ， 就 可 以 实现 专门 用 于 进行 以 太 坊 ETH 交易 的 转账 函数 了 。 

首先 在 “tool.go ”文件 中 实现 一 个 “value” 与 代 币 的 “decimal” 乘 积 函 数 ， 代 人 码 如 下 : 
// 根据 代 币 的 decimal HERE 10^decimal 后 的 值 
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// value 是 包含 浮 点 数 的 ， 例 如 0.5 个 ETH 


func GetRealDecimalValue(value string,decimal int) string { 


if strings.Contains(value, ".") dd 
// 小 数 
arr :- strings.Split(value, ".") 
if len(arr) != 2 { 


return "» 


} 

num := len(arr[1]) 

left := decimal - num 

return arr[0] -* arr[1] t strings.Repeat("O", left) 
) else { 


//| 整数 


return value + strings.Repeat("O0", decimal) 
} 


之 所 以 采用 如 上 的 函数 实现 ， 是 因为 代 币 的 交易 数值 可 以 是 浮 点 数 。 当 为 浮 点 数 的 时 候 ， 般 
要 乘 上 “10^decimal” 再 转 为 大 数 形 式 ， 目 前 Go 语言 还 没有 现成 的 库 函 数 可 以 使 用 ， 所 以 要 上 自己 
最 后 是 ETH 交易 函数 的 实现 代码 : 


// 发 送 ETH 交易 ， 或 称 转账 ETH 
// 参数 分 别 是 交易 发 起 地 址 、 交 易 接 收 地 址 、ETH 数量 、 燃 料 费 设置 


func (r *ETHRPCRequester) SendETHTransaction(fromStr, toStr, valueStr string, 
gasLimit, gasPrice uint64) (string, error) ( 


if !common.IsHexAddress(fromStr) || 'common.IsHexAddress(toStr) { 
return "", errors.New("invalid address") 


) 


to := common.HexToAddress (toStr) // 将 字符 串 类 型 的 转 为 address 类 型 的 
gasPrice := new(big.Int) .SetUint64 (gasPrice) 


// value E 10^decimal， 得 出 真实 的 转账 值 ，ETH 单位 精确 到 小 数 点 后 18 位 
realV := tool.GetRealDecimalValue(valueStr, 18) 
if realV -- "" 

return "", errors.New("invalid value") 


} 
amount, _ := new(big.Int).SetString(realV, 10) 


// 获取 nonce 
nonce :- r.nonceManager.GetNonce(fromStr) 
if nonce == nil { 
// nonce 不 存在 ， 开 始 访问 节点 来 获取 
n, err := r.GetNonce(fromStr) 
af err l= pil 
return ""，fmt.Errorf ("获取 nonce 失败 $s", err.Error()) 
} 
nonce = new(big.Int).SetUint64 (n) 
r.nonceManager.SetNonce(fromStr,nonce) // 为 当前 的 地 址 设置 nonce 
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// 构建 data， 因 为 etn 是 交易 转账 类 型 ， 所 以 data 是 空 的 ， 我 们 设置 空 字符 串 即 可 
data := []byte("") 


// 构建 交易 结构 体 
transaction := types.NewTransaction( 
nonce.Uint64(), 
EO 
amount, 
gasLimit, 
gasPrice , 
data) 


return r.SendTransaction(fromStr, transaction) 


接 下 来 进行 ETH 交易 转账 的 单元 测试 ， 在 测试 中 ， 我 们 使 用 之 前 在 “获取 链接 ”一 节 中 的 
“Infura” 所 申请 的 测试 节点 https://ropsten.infura.io/v3/2e6d9331f74d472a9d47fe99f697ca2b，, 以 及 “ 获 
取 测 试 币 ”一 节 中 在 水 龙头 网 站 所 申请 到 的 ETH 测试 代 币 进行 测试 。 当 然 ， 如 果 读 者 具备 可 以 使 
用 的 以 太 坊 主 网 钱包 且 钱 包 里 拥有 ETH 代 币 ， 当 然 也 就 可 以 使 用 主 网 的 ETH 代码 进行 测试 。 

此 外 ， 不 要 起 记 了 在 发 起 交易 之 前 ， 还 要 对 发 起 者 的 钱包 进行 解锁 ， 所 以 我 们 先 得 把 代码 中 
充当 发 起 者 的 地 址 对 应 的 “keystore ”文件 放 入 项 目 中 的 “keystores ”文件 夹 中 。 如 图 5-32 所 示 ， 
新 建 一 个 “mykey.json” 文 件 ， 并 粘贴 到 交易 发 起 者 的 “keystore” 的 “json” 文 件 中 。 

ile Edit View Navigate Code Refactor Run Iools VCS Window Help Other 
Test SendETHTransaction in eth-relay v! P 4 X Yy g| 


eth-relay keystores > fp mykey.json 


ÉJ Project » € 3e -| @mykey.json | p ethrpc test.go | * ETH RPC Requester.go | * wallet.go 
2l v eth-relay CAgo 1.9NghNsre vet] 1 ("address" :"27d2ecd2e14e52243b68fcf2321f7a9550bdc0f2", ' 


v keystores 2 
| 
& UTC--2018-12-05T03-30- 
v model 
Š eth call arg.go 
Š transaction.go 
v tool 


5-32 ”添加 钱包 的 keystore 文件 到 项 目 中 


最 终 发 送 ETH 交易 的 单元 测试 代码 如 下 : 


// 单元 测试 : 转账 ETH 
func Test SendETHTransaction(t *testing.T) { 
nodeUrl := "https://ropsten.infura.io/v3/2e6d9331£74d472a9d47£e99f£697 ca2b" 
// ropsten 测试 网 络 的 节点 链接 
from := "0x27d2ecd2el4e52243b68fcf2321f7a9550bdc0f2" // 这 个 地 址 就 是 当初 获取 测试 
代 币 的 地 址 
if from == "" || len(from) !- 42 { 
// 这 里 演示 在 调用 rpe 接口 函数 时 要 先进 行 入 参 的 合法 性 判断 
fmt .Println ("非法 的 交易 地 址 值 ") 
return 


} 
to := "Oxd8CCEFDac5F30f06C62ed13383e9563C482630Bc" 


valus mA EXE 0.2 9T ETH 
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gasLimit := uint64(100000) 
gasPrice := uint64(36000000000) 
// 当前 这 笔 交 易 消耗 的 燃料 费 最 大 值 是 (gasLimit * gasPrice)/10^18 ETH 
err := tool.UnlockETHWallet("./keystores",from,"123aaaaa") // 解锁 钱包 
if err !- nib i 
tmt.Printinierr.krror()) 
return 
} 
// 下 面 发 起 交易 转账 
txHash, err := 
NewETHRPCRequester (nodeUrl).SendETHTransaction(from,to,value,gasLimit,gasPrice) 
if err !- nil ( 
// 转账 失败 ， 打 印 出 信息 
fmt.Println("ETH 转账 失败 ， 信 息 是 ，"”，err .Error () ) 
return 
} 
fmt.Println(txHash) // 打印 出 当前 交易 的 哈 希 值 


= Test SendETHTransaction in eth-relay 
» © Tests passed: 1 of 1 test — 2s 410 ms 


«4 go setup calls» 
exO0eObc00f9b5f18df78db84135212259488c088c4aa2e0cdd49883tfdf7840efA4c 


Process finished with exit code 0 交易 的 哈 希 值 


$-33 ”发 送 ETH 交易 后 节点 返回 的 txHash 
根据 交易 的 哈 希 值 ， 可 以 到 以 太 坊 区 块 链 浏览 器 中 查询 验证 这 笔 交 易 ， 查 询 链 接 及 其 结果 如 
图 5-34 所 示 。 
e» Etherscan All Filters 


Ropsten Tesinet 
Network M Home Blockchain v Tokens v 
- 在 测试 网 络 中 查询 


Transaction Details 
Overview State Changes | New 
| This is a Ropsten Testnet Transaction Only ] 
Transaction Hash 0x0eObc00f9b5f18df78db84135212259488c088c4aa2e0cdd49883fdf7840efdc Ú 
Status: 


Block 4548101 9650568 Block Confirmations 


Timestamp © 149 days 11 hrs ago (Dec-17-2018 11:13:46 PM +UTC) 


From: 0x27d2ecd2e14652243b68fcf2321f7a9550bdcOf2 (0 


To: 0xd8ccefdac5f30fí06c62ed13383e9563c482630bc 加 


5-34 ”查询 链接 及 其 验证 结果 
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可 以 看 到 , 交易 已 经 成 功 发 送 到 以 太 坊 的 测试 节 扣 去 了 ， 对 应 的 转账 数值 也 是 所 设置 的 0.2 个 
代 币 。 
6. 发 送 ERC20 代 币 交易 


“ERC20” 代 币 的 转账 函数 和 ETH 的 不 同 主要 在 于 交易 结构 体 参 数 中 的 “value” 和 “data” 
参数 。 

根据 之 前 的 “交易 参数 的 说 明 ” 一 节 中 的 讲解 ， 在 “senRawTransaction” 接 口中 要 实现 非 ETH 
的 交易 ， 需 要 满足 下 面 几 个 条 件 : 


e “to” 参 数 是 对 应 的 智能 合约 的 地 址 。 
e “value” 参 数 为 0。 
e “data” 参 数 由 “transfer” 的 “methodId” 加 上 合约 参数 的 特定 的 十 六 进 制 格式 组 成 。 


在 上 面 的 条 件 中 ， 第 一 、 二 点 容易 实现 ， 第 三 点 需要 编写 一 个 转换 函数 ， 用 来 专门 构建 符合 
“ERC20” 标 准 的 “transfer” 人 合约 图 数 的 “data” 入 参 。 转 换 图 数 的 代码 如 下 : 
// 构建 符合 "ERC20” 标 准 的 "transfer” 合 约 函 数 的 "data” 入 参 


func BuildERC20TransferData(value,receiver string,decimal int) string { 


realValue := GetRealDecimalValue(value,decimal) // 将 value 3É LE 10^decimal 的 


格式 


valueBig, _ := new(big.Int).SetString(realValue, 10) 


// 按照 \ 交 易 参 数 的 说 明 “ 小 节 中 的 讲解 进行 构建 

methodId := "0xa9059cbb" // "0xa9059cbb" 是 transfer 的 methodId 

paraml := common.HexToHash(receiver).String()[2:] // 第 一 个 参数 ， 收 款 者 地 址 
param2 := common.BytesToHash(valueBig.Bytes()).String()[2:] 


// 第 二 个 参数 ， 交 易 的 数值 


return methodId + paraml + Param2 
} 


要 注意 的 是 ， 上 面 的 构建 图 数 仅 符合 “ERC20” 标 准 ， 对 于 非 “ERC20” 标 准 的 每 一 份 智 能 合 
约 内 的 代 币 转账 函数 ， 要 具体 情况 具体 分 析 。 人 例如， 一 个 合约 的 转账 代 币 的 函数 名 称 是 
“SendToken”， 那 么 构建 “data” 的 时 候 ， 要 针对 这 份 合 约 构建 出 符合 该 图 数 的 “data”。 
“ERC20” 代 币 转账 函数 的 代码 如 下 : 


// 发 送 ERC20 代 币 交易 ， 或 称 转账 ERC20 代 币 
// 参数 分 别 是 : 
// 交易 的 发 起 地 址 ， 代 币 的 合约 地 址 ， 交 易 接 收 地 址 ， 代 币 数 量 ， 燃 料 费 设置 ， 代 币 的 decimal 值 
func (r *ETHRPCRequester) SendERC20Transaction( 

fromStr, contact, receiver, valueStr string, gasLimit, gasPrice uint64, decimal 
rnb) (string, error) | 


if !common.IsHexAddress(fromStr) || 
!common.IsHexAddress (contact) || 
!common.IsHexAddress(receiver) { 
return "", errors.New("invalid address") 


) 


to := common.HexToAddress(contact) // 将 合约 contact 字符 串 类 型 转 为 address 类 型 


222 | 区 块 链 以 太 坊 DApp 开发 实战 
gasPrice := new(big.Int) .SetUint64 (gasPrice) 


// 结构 体 中 的 value 字段 为 0 
amount := new(big.Int).SetInt64(0) 


// 获取 nonce 
nonce :- r.nonceManager.GetNonce(fromStr) 
if nonce == nil { 
// nonce 不 存在 ， 开 始 访问 节点 获取 
n, err := r.GetNonce(fromStr) 
if err !- nil { 
return "", fmt.Errorf("JkHX nonce 失败 $s", err.Error()) 


} 
nonce = new(big.Int).SetUint64 (n) 


r.nonceManager.SetNonce(fromStr,nonce) // 为 当前 的 地 址 设置 nonce 
f 


// 构建 data, AX value 转账 数值 由 data 携带 


data := tool.BuildERC20TransferData(valueStr, receiver, decimal) 


dataBytes := common.FromHex(data) // 使 用 以 太 坊 提供 的 函数 将 十 六 进 制 数 据 转 为 字 节 
// 构建 交易 结构 体 


transaction := types.NewTransaction( 
nonce.Uint64(), 
Eo, 
amount, 
gasLimit, 
gasPrice , 
dataBytes) 


return r.SendTransaction(fromStr, transaction) 


“ERC20” 代 币 转账 的 测试 需要 用 到 一 份 代 币 合 约 ， 根 据 第 4 章 “ 智 能 合约 的 编写 、 发 布 、 
调用 ”一 节 中 学 到 的 知识 ， 我 们 首先 在 以 太 坊 测试 网 络 中 发 布 一 份 “ERC20” 代 币 合约 ， 要 发 布 的 
合约 是 “实现 ERC20 代 币 智能 合约 ”一 节 中 的 “MyToken.sol ”示例 ， 代 币 名 称 是 “MFTC”。 在 
Mist 中 先 切换 节点 的 网 络 到 “Ropsten ”测试 网 络 模式 ， 再 到 Remix 提取 合约 的 “Bytecode”， 而 
后 粘贴 到 Mist 中 进行 发 布 。 

当然 也 可 以 使 用 已 经 在 测试 网 络 “Ropsten ”中 发 布 了 的 测试 “ERC20” 智 能 合约 ， 合 约 地 址 
是 OxX99BD856201210D3B4b76A6f8c6fFf3eCdC485758. 

单元 测试 代码 如 下 : 

// 单元 测试 : 转账 ERC20 代 币 


func Test SendERC20Transaction(t *testing.T) { 


// ropsten 测试 网 络 的 节点 链接 
nodeUrl := "https://ropsten.infura.io/v3/2e6d9331f74d472a9d47fe99f697ca2b" 


from := "0x27d2ecd2e14e652243b68fcf2321f7a9550bdc0f2" 
// 这 个 地 址 就 是 当初 获取 测试 代 币 的 地 址 
if from == "" || len(from) != 42 { 


// 这 里 演示 在 调用 rpc 接口 函数 时 先进 行 入 参 的 合法 性 判断 
fmt .Println ("非法 的 交易 地 址 值 ") 


return 
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A 
:= "0x99BD856a01210D3B4b76A6f8c6fFf3eCdC485758" 
// 在 测试 网 络 上 发 布 的 MFTC 代 币 智能 合约 
amount  :- "10" // 转账 ERC20 代 币 的 数值 ，10 个 MFTC 
decimal := 18  // MFTC 代 币 单位 精确 到 小 数 点 后 的 位 数 


receiver := "Oxd8CCEFDac5F30f06C62ed13383e9563C482630Bc" // 接收 者 的 以 太 坊 地 址 
gasLimit := uint64(50000) 


gasPrice := uint64 (24000000000) 
// 当前 这 笔 交 易 消 耗 的 燃料 费 最 大 值 是 (gasLimit * gasPrice) / 10^18 ETH 


err := tool.UnlockETHWallet("./keystores", from, "123aaaaa") // 解锁 钱包 
if err !- nil { 


imt.PrinbElin[(err,.Error(í)) 
return 

} 

// 下 面 发 起 转账 交易 


txHash, err := 
NewETHRPCRequester (nodeUrl). 


SendERC20Transaction(from, to,receiver,amount, gasLimit, gasPrice,decimal) 
if err !- nil { 


// 转账 失败 ， 打 印 出 信息 
fmt.Println("ETH 转账 失败 ， 信 息 是 : "，err .Error () ) 


return 


} 
fmt.Println(txHash) // 打印 出 当前 交易 的 哈 希 值 


运行 单元 测试 转账 后 ， 可 以 看 到 控制 全 输出 了 交易 的 “hash” 值 〈 见 图 5-35) : 
Ox2bfb41beab942f88cace64d2d4f8b85ad6b07468e22cb92db244443567adfaff 


*. Test SendERC20Transaction in eth-relay 


图 £ » (Q Tests passed: 1 of 1 test 1s 277 ms 


( 4 go setup ca 
Ox2bfb41beab942f88cace64d2d4f8b85ad6b07468e22cb92db244443567adfaff 


Process finished with exit code 8 


5-35 ”控制 台 输 出 了 交易 的 “hash” 值 


根据 这 个 “hash” 值 到 以 太 坊 测试 网 络 “Ropsten” 的 区 块 链 浏览 器 中 查询 ， 从 页 面 中 可 以 看 
到 已 经 转账 成 功 了 ， 如 图 5-36 Pr. 


人 至此，“ERC20” 转 账 请 求 图 数 成 功 运行 。 
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e Etherscan All Filters 


Ropsten Testnet 
Network Home 
Transaction Details 

Overview Event Logs (1) State Changes | New | 


[ This is a Ropsten Testnet Transaction Only ] 


Transaction Hash: Ox2bíb41beab942f88cace64d2d418b85ad6b07468e22cb92db244443567adfaff [0 


Status: © success N, 
Block 4656960 951791 Block Confirmations 


对 应 转账 10 个 MFTC 
Timestamp: © 14T days 23 hrs ago (Doc-19-2018 11:38:46 AM Y 
From: 0x2 /d206cd20614052243b68ícf2321t/a8550bdcUOf2 


To: Contract 0x99bd856a01210d3b4b/6a6f8c6fíff3ecdc485758 € 加 


Tokens Transferred: + From 0x27d2ecd2e14... To Oxd8ccefdac5f3. . 


图 5-36 转账 成 功 


5.3 区 块 事件 监听 


在 本 节 中 ， 我 们 将 实现 “以 太 坊 中 继 ” 中 最 重要 ， 也 是 最 复杂 的 一 部 分 功能 ， 即 通过 过 历 区 
块 内 部 的 交易 记录 来 实现 区 块 事件 的 监听 ， 其 必要 性 以 及 实现 原理 见 “ 区 块 表 历 ” 一 节 。 
代码 的 实现 步骤 如 下 : 


d) 从 数据 库 中 获取 上 一 次 成 功 饥 历 的 非 分 叉 状 态 的 区 块 信息 得 到 区 块 号 A， 或 通过 以 太 坊 
接口 “eth_blockNumber” 获 取 新 生成 区 块 的 区 块 号 A。 

(2) 调用 以 太 坊 接口 “eth_blockNumber”， 获 取 最 新 生成 区 块 的 区 块 号 B. 

(3) 比较 A RI B 的 大 小 关系 ， 得 出 目标 区 块 号 “target”。 

(4) 得 到 “target” 后 ， 调 用 以 太 坊 接口 “eth getBlockByNumber” 获 取 区 块 的 数据 。 

(5) 数据 库 保存 “target” 对 应 的 区 块 信息 。 

(6) 检测 是 否 存 在 区 块 分 又 ， 这 个 步骤 可 以 得 出 分 又 事件 。 

CL 解析 区 块 内 的 数据 ， 读 取 内 部 的 “transactions” 交 易 信 息 ， 分 析 得 出 各 种 合约 事件 。 

C8) 数据 库 保 存 每 笔 交 易 信 息 。 


从 上 面 的 步骤 可 知 ， 我 们 需要 用 到 数据 库 。 数 据 库 中 的 表 有 两 个 ， 一 个 是 存储 区 块 信息 的 表 ; 
男 一 个 是 存储 区 块 内 交易 信息 的 表 。 所 涉及 的 以 太 坊 接口 调用 有 3 个 : 一 个 是 “eth_blockNumber”; 
男 一 个 是 “eth_getBlockByNumber”; 最 后 一 个 是 “eth_getBlockByHash ”， 该 接口 在 检测 区 块 分 
叉 的 时 候 会 用 到 。 这 3 个 接口 的 访 问 代码 请 参考 “编写 访问 接口 代码 ”一 他。 
对 应 上 述 步 又 ， 我 们 给 出 过 历 区 块 实现 事件 监听 的 流程 图 ， 如 图 5-37 所 示 。 
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数据 库 获取 上 次 成 功 的 站 分 叉 区 块 
的 区 块 号 A 


每 轮 的 开 
始点 


No 、 Yes 调用 
A=A+1 arg blockNumber 获取 最 新 生 


成 区 块 号 作为 A 
调用 
blockNumber 获取 最 新 生 


B < target ? 


以 target 为 县 调用 
getBlockByNumber target = C 
获取 区 块 信息 
a 
No 


调用 
blockNumber 获取 最 新 生 
Yes 


保存 区 块 信息 


Yes 
交易 信息 
m 


图 5-37 ”遍历 区 块 实现 事件 监听 的 流程 图 
完成 上 面 的 整体 遍历 代码 比较 多 ， 下 面 将 分 几 个 小 节 进 行 详细 讲解 。 
5.3.1 创建 数据 库 
px Bui Jj HK] MySQL 数据 库 ， 在 安装 好 了 MySQL 并 局 动 之 后 ， 进 入 到 数据 库 控制 台 


创建 数据 库 ， 以 供 以 太 坊 中 继 程序 使 用 ， 可 以 参考 下 面 的 SQL 语句 创建 一 个 名 为 eth_relay、 字 符 
集 编码 为 utf 的 数据 库 ， 使 用 utfs 字符 集 编码 是 因为 utf8 字符 集 可 以 让 数据 库 中 的 表 兼 容 中 文 。 
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在 控制 全 输入 下 面 的 代码 并 按 回 千 键 : 
CREATE DATABASE eth relay DEFAULT CHARACTER SET utf8 COLLATE utf8 general ci; 


创建 完 数 据 库 后 ， 输 入 下 面 的 代码 ， 可 看 到 刚刚 创建 的 数据 库 〈 见 图 5-38) : 
Show databases; 


sql?» show databases; 


information schema 


刚刚 创建 的 数据 库 


eth relay 


len 


mysql 
performance schema 


4 
3 rows in set (0.00 sec) 


图 5-38 ”在 数据 库 控 制 台 输入 命令 查看 创建 的 数据 库 


5.3.2 ”实现 数据 库 的 连接 器 


在 创建 完 数 据 库 后 ， 我 们 需要 在 代码 中 完成 一 个 专门 用 来 管理 数据 库 连 接 的 对 象 。 
首先 在 项 目 主 文件 夹 下 创建 一 个 “dao” 文 件 夹 ， 专 门 用 来 存放 数据 库 相 关 的 代码 文件 ， 再 到 
该 文件 夹 下 创建 一 个 名 称 为 “mysql.go” 的 文件 。 接 下 来 在 这 个 文件 中 编写 数据 库 连 接 器 相关 的 代 
i3, tn 5-39 所 示 。 
a eth-relay ` ™ dao ` Ë mysql.go 


a| É Project v © |æ- l € mysql.go 
Ev eth-relay C:\go 1.9\lIgh\sro\eth-relay| 1 package dao 


和 dao 


* block.go 

8$ transaction.go 
keystores 

model 
tool 


5-39 ”创建 一 个 名 称 为 “mysql.go” 的 文件 
要 想 在 Golang 语言 中 使 用 MySQL 的 功能 ， 目 前 有 两 种 选择 : 
(OD 目 己 动手 与 一 个 MySQL HEE. 
(2) 使 用 第 三 方 开源 的 文 持 MySQL 的 数据 库 操作 库 。 
对 于 上 面 的 两 种 选择 ， 我 们 采用 第 二 种 ， 学 有 余力 的 开发 者 也 可 以 符 试 目 己 编写 数据 库 操 作 
库 。 目 前 第 三 方 开 源 的 数据 库 操 作 库 有 很 多 , 例如 gorm、xorm 等 ,在 下 和 面 的 示例 中 ,我 们 选择 “xorm” 
作为 项 目的 数据 库 操 作 库 。“xorm” 库 的 官方 技术 文档 链接 是 http://www.xorm.io/docs/。 
在 Goland 界面 的 确 部 打开 “Terminal” 探 制 台 ， 然 后 使 用 Golang 的 “go get” 命 令 下 载 远 程 
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依赖 包 。 我 们 需要 下 载 两 个 ， 对 应 的 命令 ( 见 图 5-40) 分 别 是 : 


(1) go get github.com/go-sql-driver/mysql (下 载 “MySQL” 操 作 库 ) 。 
(2) go get github.com/go-xorm/xorm 〈 下 载 “xorm” 数 据 库 操作 库 ) o 


上 面 乙 所 以 还 要 下 载 “go-sql-drivermysql” 库 ， 是 因为 “xorm” 内 部 的 代码 中 依赖 到 它 ， 这 
也 是 代码 库 与 代码 库 之 间 互 相依 赖 要 做 的 常规 操作 。 


Terminal 


ru Local | Local (1) 


Microsoft Windows [M 10.0.17134.407] 
(c) 2018 Microsoft corporation. If fi. 


C:\go_1.9\lgh\src\eth-relayþpþgo get github.com/go-sql1-driver/mysql 


C:Ngo 1.9\leh\src\eth-relayteo get github.com/go-xorm/xorm 


C: \go_1.9\lgh\src\eth-relay> 


*GTODO VY 9 Version Control P 4: Run 
5-40 ”使 用 Go 语言 的 Get 命令 获取 依赖 包 


1. 定 义 连接 器 


MySQL 数据 库 的 连接 需要 通过 一 系列 参数 来 完成 ， 必 需 的 参数 有 下 面 5 个 : 
数据 库 域名 ， 就 是 数据 所 在 计算 机 的 “IP” 地 址 。 
数据 库 端 口 ， 数 据 库 程序 在 局 动 成 功 后 监听 电脑 的 应 用 程序 端口 ， 默 认 的 端口 是 3306。 
数据 库 名 称 ， 程 序 连接 数据 库 软 件 的 时 候 所 要 使 用 的 数据 库 名 称 ， 例 如 我 们 前 面 一 节 所 创建 


的 “eth relay" , 


数据 库 用 户 ， 就 是 在 安装 数据 库 时 设置 的 用 户 ， 数 据 库 登录 用 户 名 默认 是 “root”。 
数据 库 密 码 ， 对 应 登录 用 尸 名 的 登录 窗 码 。 


除了 上 面 的 参数 外 ， 数 据 库 设置 方面 还 有 其 他 的 参数 可 以 选择 。 为 了 方便 管理 ， 我 们 在 
“mysqlgo” 文 件 中 定义 了 一 个 MySQL 配置 信息 结构 体 ， 代 人 码 如 下 所 示 : 


// MySQL 连接 配置 信息 
type MysqlOptions struct { 


Hostname string 
Port string 
User string 
Password string 
DbName string 
TablePrefix string 


MaxOpenConnections int 
MaxlIdleConnections int 
ConnMaxLifetime ink 


// 数据 库 服务 器 域名 

// 端口 

// 数据 库 用 户 

// 数据 库 密码 

// 数据 库 名 称 

// 数据 库 表 前 级 

// 数据 库 最 大 连接 数 

// 数据 库 最 大 空闲 连接 数 

// 空闲 连接 多 长 时 间 被 回收 ， 单 位 为 秒 


连接 的 配置 信息 是 连接 器 所 拥有 的 属性 ， 因 此 我 们 可 以 在 定义 连接 器 结构 体 的 时 候 将 配置 信 
息 结构 体 添加 到 里 面 ， 作 为 它 的 一 项 属性 。 此 外 ， 最 为 重要 的 是 连接 嚣 中 需要 拥有 “xorm” 框 架 
的 实例 ， 这 样 才能 使 用 “xorm” 来 操作 数据 库 。 最 终 连接 器 的 结构 体 代码 如 下 : 
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// MySQL 连接 器 结构 体 

type MySQLConnector struct ( 
options *MysqlOptions  // 数据 库 配 置 结 构 体 指针 
tables [linterface()  // 数据 库 表 的 结构 体 集合 
Db *xorm.Engine // xorm 框架 指针 


2. 连接 数据 库 

在 定义 好 了 连接 器 后 ， 现 在 来 实现 数据 库 的 连接 。 实 现 连接 的 代码 将 会 编写 在 连接 器 初始 化 
的 函数 内 ， 由 于 第 三 方 框架 封装 好 了 数据 库 连 接 及 增 、 删 、 改 、 查 的 数据 库 操作 ， 使 得 我 们 在 使 用 
这 些 数据 库 功 能 的 时 候 不 需要 编写 很 多 代码 。 

初始 化 函数 的 整体 逻辑 分 为 4 步 : 


CD 连接 数据 库 。 

(2) 设置 数据 库 配 置 。 
(3) 不 存在 则 创建 数据 表 。 
(4) 同步 表格 的 结构 变化 。 


整体 代码 如 下 所 示 ，“NewMqSQLConnector” 函 数 负责 实例 化 数据 库 连接 器 ，“ createTables” 
负责 创建 和 同步 数据 表 。 在 “xorm” 中 ， 当 数据 库 域 名 与 本 地 计算 机 相关 时 ， 数 据 库 连 接 可 以 省 
略 域名 与 端口 设置 。 


// tables 是 数据 表 的 结构 体 实例 数组 
func NewMqSQLConnector(options *MysqlOptions, tables []interface(í]) 
MySQLConnector { 
var connector MySQLConnector 
connector.options - options 
connector.tables - tables 
// 设置 数据 库 连 接 的 url 
urli ;= Tn 
if options.Hostname == "" || options.Hostname == "127.0.0.1" { 
url - fmt.Sprintf( 
"$s:t$sQ/$s?charset-utf8&parseTime-True", 
options.User, options.Password, options.DbName) 
) else { 
url = tmt.5prinbLFEli 
"$s:$stcp($s:$s)/$s?charset-utf8&parseTime-True", 
options.User, options.Password, options.Hostname, options.Port, 
options.DbName) 
} 
db, err := xorm.NewEngine("mysql", url) // 以 MySQL 数据 库 类 型 实例 化 
f err l= nil 1 
panic (fmt .Errorf ("数据 库 初 始 化 失败 ss", err.Error())) 
} 
tbMapper := core.NewPrefixMapper (core.SnakeMapper{}, options.TablePrefix) 
db.SetTableMapper (tbMapper) 
db.DB().SetConnMaxLifetime(time.Duration(options.ConnMaxLifetime) * 
time.Second) 
db.DB().SetMaxIdleConns (options.MaxIdleConnections) 
db.DB().SetMaxOpenConns (options.MaxOpenConnections) 


// db.ShowSQL(true) // 是 否 开 局 打印 SQL 日 志 到 控制 台 
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if err = db.Ping();err != nil ( 
panic (fmt .Errorf ("数据 库 连 接 失败 $s", err .Error ())) 
} 
connector.Db = db 
// 创建 数据 表 ， 策 略 是 不 存在 则 创建 
if err := connector.createTables(); err != nil { 
panic (fmt .Errorf ("创建 数据 表 失 败 $s", err.Error())) 
} 
return connector 


} 


// 创建 数据 表 ， 策 略 是 不 存在 则 创建 
func (s *MySQLConnector) createTables() error ( 
if len(s.tables) == 0 { 
// 没有 数据 表 则 需要 创建 
return nil 
} 
if err := s.Db.CreateTables(s.tables...); err != nil { 
return fmt.Errorf("create mysql table error:$s", err.Error()) 


} 
// 同步 数据 表 的 修改 
if err := s.Db.Sync2(s.tables...); err I= nil { 
return fmt.Errorf("sync table error:$s", err.Error()) 
} 


return nil 


在 “dao” 文 件 夹 下 新 建 一 个 MySQL 单元 测试 文件 “mysql_test.go”, 编写 单元 测试 代码 如 下 : 
// 测试 连接 数据 库 


func Test NewMqSQLConnector(t *testing.T) { 
option := MysqlOptions( 


Hostname: "127.0.0.1", // 本 地 数据 库 
Port: "3306", // 默认 端口 
DbName : "eth relay", // 数据 库 名 称 
User: roD // 用 户 名 
Password: "1234506. // 密码 
TablePrefix: "eth ", // 数据 表 前 绥 


MaxOpenConnections: 10, 
MaxlIdleConnections: 5, 
ConnMaxLifetime: 159; 
} 
tables := []interface{}{} // 不 创建 数据 表 
mysql := NewMqSQLConnector(&option, tables) 


if mysql.Db.Ping() == nil { 
fmt .Println ("数据 库 连 接 成 功 ") 
Jelse( 


fmt .Println ("数据 库 连 接 失 败 ") 
} 


测试 结果 如 图 5-41 所 示 ， 可 以 看 到 数据 库 连 接 成 功 了 。 
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*. Test NewMqSQLConnector in eth-relay/dao 


» (9 Tests passed: 1 of 1 test - 21 ms 


«4 go setup calls» 
[xorm] i 2018/12/12 20:21:57.747269 PING DATABASE mysql 
C 2018/12/12 20:21:57.769210 PING DATABASE mysql 


Process finished with exit code 0 


5-41 连接 数据 库 单元 测试 函数 的 运行 结果 


5.3.3 ”生成 数据 表 


在 MySQL 中 创建 数据 表 的 方式 有 两 种 : 第 一 种 是 直接 在 MySQL 的 控制 台中 输入 创建 数据 表 
丁 创建 ; 另 一 种 是 在 代码 中 使 用 数据 库 ORM 框架 进行 创建 。 第 二 种 方式 的 操作 往 
往 比较 方便 。 本 项 目 使 用 的 “xorm” 数 据 库 操作 库 就 支持 第 二 种 方式 。 


的 SQL 语句 进 和 


1. 定义 数据 表 


根据 “xorm ”文档 的 介绍 ， 我 们 可 以 在 代码 文件 中 以 定义 数据 结构 体 的 形式 来 对 应 要 创建 的 
数据 表 。 如 下 代码 所 示 为 存储 区 块 信息 数据 表 的 数据 结构 体 。 需要 注意 的 是 , 目前 定义 的 结构 体 不 
需要 存储 完 以 太 坊 区 块 的 所有 数据 了 字段， 只 挑选 重要 的 部 分 进行 存储 即 可 。 


// 存储 区 块 信息 的 区 块 结构 体 
type Block struct { 


Id int64 ^json:"id"^ // 主键 
BlockNumber string ^json:"block number"^ // 区 块 号 
BlockHash string ^json:"block hash" // 区 块 的 哈 希 值 
ParentHash string `json:"parent hash"^  // 父 区 块 的 哈 希 值 
CreateTime int64 "^json:"create time"^  // 区 块 的 生成 时 间 
Fork bool  ^json:"fork"^ // 是 否 为 分 叉 区 块 


ESSEN ES “dao” 文 件 夹 下 的 新 建文 件 “block.go” 中 ， 如 图 5-42 所 示 。 


E block.go | 


OQ x90 


B- Project v 


gv eth-relay ^35 1. package dao 


v dao à 
| 
8 mysql.go 5 rd 
5? mysql test.go 
3 transaction.go 
keystores 
model 


9\lgh\s! 1 


BlockHash 


Fork bool 


tool 
E block scanner.go 
7, block scanner test.qo 


ParentHash string 
CreateTime int64 


// TFI Pe EPA BE 
type Block struct { 

int64 
BlockNumber string 
string 


“Json: id 一 

“Json: "block_number 
“Json: block_hash” 
“Json; "parent_hash 
"json:"create time" 
“json: "fork" 


542 ”区 块 结构 体 代 码 


同样 地 ， 在 “dao” 文 件 夹 下 创建 “transaction.go” 文 件 ， 用 来 编写 代码 以 便 从 存储 区 块 中 解 


析出 交易 信息 结构 体 。 代 码 如 下 所 示 : 
// 对 应 于 数据 库 表 的 交易 数据 结构 体 


type Transaction struct 1 
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Id int64 ^json:"id"^ // 主键 

Hash string ^json:"hash" // 交易 的 哈 希 值 

Nonce string ^json:"nonce"" // 交易 的 序列 号 

BlockHash string ^json:"blockHash"" // 当前 交易 被 打包 的 区 块 的 哈 希 值 


BlockNumber string ^json:"blockNumber" // 当前 交易 被 打包 在 的 区 块 的 区 块 号 
TransactionIndex string '^json:"transactionIndex"' 


// 当前 交易 在 区 块 已 打包 交易 数组 中 的 下 标 


From String '"json:"from" // 交易 发 起 者 的 地 址 
To String "son: "Eo" // 交易 接收 者 的 地 址 
Value string ^json:"value"' // 交易 的 数值 
GasPrice string ^json:"gasPrice"' // gasPrice 

Gas string ^json:"gas" // gasLimit 
Input string ^xorm:"text" json:"input"^ // data 


Hp, “input” 变 量 在 数据 表 中 的 数据 类 型 是 “text”。 "text" E MySQL 中 是 文本 存储 类 型 ， 
因为 “input” 的 内 容 比较 多 ， 所 以 将 该 变量 设 为 “text” 类 型 ， 以 存储 较 多 的 数据 。 根 据 “xorm” 
技术 文档 的 介绍 ， 如 果 在 Go 代码 中 的 变量 使 用 默认 的 “string” 类 型 ， 而 不 在 创建 数据 表 的 时 候 指 
定 类 型 ， 那 么 默认 将 会 使 用 “varchar(255)” 类 型 ， 这 种 类 型 的 变量 是 不 能 存储 过 多 数据 的 ， 此 时 
如 果 在 进行 插入 操作 的 时 候 超出 了 数据 量 ， 就 会 出 现 数据 库 错 误 。 

2. 创建 数据 表 

使 用 “xorm” 库 来 创建 数据 表 是 比较 简单 的 ， 直 接 调用 我 们 前 面 在 数据 库 连 接 器 代码 中 实现 
的 “NewM9qSQLConnector” 畏 数 ， 对 定义 好 的 “Block” 和 “Transaction” 结 构 体 传 入 参数 即 可 。 

修改 之 前 的 连接 数据 库 的 测试 函数 ， 添 加 创建 表格 的 代码 ， 让 测试 函数 在 连接 数据 库 成 功 后 
进行 数据 表 的 创建 ， 测 试 代 码 如 下 : 

// 测试 连接 数据 库 ， 同 时 创建 数据 表 


func Test NewMqSQLConnector(t *testing.T) { 
option := MysqlOptions( 


Hostname: "127.0.0.1",  // 本 地 数据 库 
Port: "3306", // 默认 端口 
DbName : "eth relay",  // 数据 库 名 称 
User: "PUDE". // 用 户 名 
Password: "2 // 密码 
TablePrefix: ER // 数据 表 前 绥 


MaxOpenConnections: 10, 
MaxlIdleConnections: 5, 
ConnMaxLifetime: I5 
} 
tables := []interface{}{} 
tables = append (tables,Block{},Transaction{}) // 添加 数据 表 的 数据 结构 体 
NewMqSQLConnector(&option, tables) 
// 传 参 进去 ， 对 应 的 结构 体 将 会 被 xorm 目 动 解析 并 创建 数据 表 
fmt .Println(" 创 建 数据 表 成 功 ") 
} 


“xorm” 根 据 数 据 结构 体 创建 数据 表 名 称 的 方式 是 ， 在 所 设置 的 数据 表 前 级 “TablePrefix” 上 
加 上 “ ”， 再 加 上 结构 体 名 称 的 小 写字 母 。 如 条 没有 设置 数据 表 前 级 ， 那 么 将 会 直接 使 用 结构 体 
名 称 的 小 号 ， 例 如 “Block” 数 据 表 在 数据 库 里 面 对 应 的 数据 表 名 称 是 eth. block. 
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运行 上 述 的 测试 函数 后 ， 可 以 在 MySQL 数据 库 控 制 台 输入 如 下 命令 组 来 下 看 数据 表 是 否 生 


use eth relay; 
show tables; 


测试 与 检验 结果 如 图 5-43 Brn o 
= Test NewMqSQLConnector in eth-relay/dao 
© » @ Tests passed: 1 of 1 test - 116 ms 


«4 go setup calls» 
[xorm] [info] 2018/12/16 16:13:40.855407 PING DATABASE mysql 
2018/12/16 16:13:40.940356 Table eth transactio 


创建 数据 表 成 功 


Process finished with exit code 9 


ysqb[use eti relay: 
Database change 
ysql?| show tables; 


十 -— 
Tables in eth relay | 


— 


th block | - n 
数据 表 创 建成 功 


- 4+ 


2 rows in set (0.00 sec) 


5-43 ”在 数据 库 控制 台 输 入 命令 查看 创建 好 的 数据 表 


5.3.4 KHEM RS 


创建 好 数据 库 和 数据 表 之 后 ， 在 项 目 文件 夹 “eth-relay” 下 创建 文件 “block scanner.go”， 如 
图 5-44 所 示 。 


eth-relay ~ block scanner.go 


67 Project v Q3 l- F block_scanner.go 
v eth-relay C^go 1.9NghNsreveth-r| 1 package main 
dao 
keystores 


m 1:Project 


& ETH RPC Client.go 

9 ETH RPC Requester.go 
& ethrpc test.go 

9 main.go 


9 nonce manager.go 


5-44 ”创建 的 “block scannergo" 文件 
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区 块 扫描 器 的 代码 将 编写 在 该 文件 中 ， 由 于 扫 摘 器 的 实现 代码 比较 多 ， 因 此 下 面 将 按照 功能 
进行 分 模块 讲解 。 

1. 定义 遍历 器 

因为 要 通过 访问 以 太 坊 接口 来 获取 区 块 内 的 数据 ， 所 以 区 块 遇 历 器 结构 体 中 需要 定义 一 个 以 
太 坊 的 “RPC” 请 求 者 ， 即 我 们 前 面 内 容 中 所 编写 的 “ETHRPCRequester”。 此 外 ， 区 块 通 历 后 获 
取 的 数据 要 存放 到 数据 库 中 ， 那 么 过 历 器 结构 体 中 还 需要 定义 数据 库 连 接 器 对 象 。 

区 块 表 有 历 是 一 个 循环 过 程 ， 为 达到 区 块 分 又 检测 ， 需 要 在 每 次 成 功 过 历 后 ， 在 内 存 中 存储 上 
一 次 过 历 的 区 块 ， 以 便 在 新 一 轮 的 过 历 中 把 当前 轮 次 区 块 的 哈 希 值 与 上 次 的 哈 希 值 进 行 比较 ,判断 
它们 是 否 一 致 ， 如 果 不 一 致 ， 就 证 明 出 现 了 分 又 。 因 此 在 过 历 器 的 结构 体 中 还 需要 定义 用 来 存储 每 
次 抽 历 成 功 后 上 一 次 的 区 块 。 

区 块 表 历 占 的 结构 体 定义 及 其 实例 化 代码 如 下 所 示 : 
// 区 块 遍历 器 


type BlockScanner struct { 
ethRequester ETHRPCRequester // 以 太 坊 rpe 请 求 者 对 象 


mysql dao.MySQLConnector  // 数据 库 连 接 器 对 象 

lastBlock *dao.Block // 用 来 存储 每 次 壳 历 后 上 一 次 的 区 块 
lastNumber  *big.Int // 上 一 次 区 块 的 区 块 号 

fork bool // 区 块 分 又 标记 位 

stop chan bool // 用 来 控制 是 否 停止 遍历 的 管道 
lock sync.Mutex // EFS, AFE 


} 


func NewBlockScanner (requester ETHRPCRequester, mysql dao.MySQLConnector) 
*BlockScanner { 
return &BlockScanner( 
ethRequester: requester, 


mysql: mysql, 
lastBlock: &dao.Blockí], 
COTR: false, 

stop: make (chan bool), 
TOCE: sync .Mutex{}, 


2. 区 块 分 叉 检 测 

在 以 太 坊 中 ,分 叉 区 块 中 打包 了 的 交易 是 不 算数 的 ， 也 就 是 无 效 的 ， 所 以 我 们 在 遍历 区 块 时 
要 过 滤 掉 分 又 区 块 ， 对 这 些 区 块 不 做 交易 读 取 人 处理 。 

以 太 坊 区 块 分 叉 在 代码 层面 主要 是 通过 区 块 父子 关系 的 哈 希 值 进行 判断 。 举 个 例子 ， 在 区 块 
高 度 为 15 的 时 候 ， 我 们 获取 到 区 块 A 的 哈 希 值 是 “0x123”， 此 时 高 度 累 加 1 变 为 16， 我 们 根据 
16 的 高 度 去 获取 对 应 的 区 块 B， 然 后 判断 区 块 B 的 父 块 哈 希 值 (parent hash) 是否 是 区 块 A 的 哈 
希 值 。 因 为 高 度 15 的 区 块 必须 是 高 度 16 区 块 的 父 区 块 ， 所 以 A 区 块 的 哈 希 值 必 须要 等 于 B 区 块 
的 父 块 哈 希 值 ， 否 则 就 是 分 又 了 。 

根据 上 述 区 块 分 叉 的 判断 条 件 结合 “区 块 融 历 器 ”结构 体 中 上 一 次 的 区 块 变量 ,我 们 可 以 编 
写 如 下 判断 是 否 分 叉 的 代码 : 
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// 判断 是 否 分 叉 的 函数 ， 若 返回 true， 则 是 分 叉 


func (scanner *BlockScanner) isFork(currentBlock *dao.Block) bool { 
if currentBlock.BlockNumber -- "" 
panic("invalid block") 
] 
// scanner.lastBlock.BlockHash == currentBlock.ParentHash 判断 上 一 次 的 区 块 哈 希 值 


是 否 是 当前 区 块 的 父 区 块 哈 希 值 
if scanner.lastBlock.BlockHash == currentBlock. UM | | 
scanner.lastBlock.BlockHash == currentBlock.ParentHash 


scanner.lastBlock = currentBlock // 没有 发 生 分 又， a 
return false 

} 

return true 


} 
3. 获取 分 又 点 区 块 的 思 


分 又 点 区 块 的 意思 是 东 个 区 块 分 又 是 从 它 开 始 的 。 在 检测 出 存在 分 又 区 块 后 ， 需 要 在 数据 库 
中 找到 当前 分 又 区 块 的 “分 又 点 区 块 ”。 然 后 将 从 该 “分 叉 点 区 块 ” 的 区 块 号 开始 到 分 又 块 区 块 号 
之 间 的 区 块 全 部 标记 为 分 又 ， 标 志 位 对 应 “block” 区 块 结构 体 中 的 “fork” 变 量 ， 如 图 5-45 Bron. 


分 义 时 候 的 链 


这 部 分 的 三 个 区 块 将 会 被 设置 
fork = true。 其 中 6” 就 是 
代码 检测 出 的 分 又 块 


图 5-45 分 又 点 区 块 
寻找 “分 又 点 区 块 ” 需 要 理解 下 面 的 知识 点 : 


寻找 所 依赖 的 是 “ 父 块 哈 币 值 ”， 即 父 区 块 的 哈 布什 

e 寻找 算法 是 递归 算法 ， 不 MAN 分 又 区 块 之 前 在 本 地 数据 库 中 存在 的 区 块 时 ， 再 
跳出 递归 。 

@ 寻找 区 块 的 步骤 是 先 从 本 地 的 数据 库 中 寻找 ， 因 为 我 们 在 每 次 成 功 获取 一 个 区 块 的 信息 后 都 
会 把 它 存 储 于 本 地 的 数据 库 中 ， 如 果 本 地 数据 库 没 有 寻找 到 ， 就 再 访问 以 太 坊 接口 
“eth getBlockByHash” 来 获取 。 


整体 的 流程 图 如 图 5-46 所 示 。 
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根据 parent 
hash 在 数据 库 中 
Cm Yes 
o 


查找 
No 
根据 parent 
hash 去 以 太 坊 中 
查找 


Yes N 
抛 出 错误 


标记 范围 内 的 
区 块 为 分 又 


触发 分 又 处 
E, EARD 


5-46 “寻找 分 又 点 区 块 的 设计 流程 图 


综合 流程 图 和 上 面 的 “检测 分 又 图 ”， 下 面 我 们 再 通过 图 文 进行 理解 。 
假设 此 时 区 块 表 历 没 有 出 现 分 又 的 情况 ， 正 币 地 进行 到 了 3A 区 块 ， 如 图 5-47 所 示 。 


5-47 IEN SUPCER 3A 


区 块 壳 历 继续 进行 ， 此 时 过 历 到 SA， 发 现 没 有 出 现 分 又 ， 然 后 将 壳 历 器 中 的 “lastBlock” 变 
量 设置 为 SA， 在 下 一 次 的 循环 中 将 继续 检测 分 又 ， 如 图 5-48 所 示 。 
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继续 遍历 到 区 块 5A， 成 功 后 ， 发 现 没 有 分 义 。 
此 时 变量 lastBlock 变 为 存储 5A。 下 一 步 准备 
检测 到 分 又 


ES SES 
EE 


图 5-48 区 块 正 常 遍历 


当 获 取 到 以 太 坊 最 新 生成 (latest) 的 区 块 时 ， 此 时 节点 中 刚好 同步 好 了 一 条 最 优 链 (AB. 5B, 
6B 所 在 链 ) ， 最 优 链 中 ，6B 区 块 是 最 新 的 ， 因 此 节点 便 将 6B 区 块 返回 给 客户 端 。 客 户 问 一旦 发 
现 6B 区 块 的 父 块 哈 希 值 (parent hash) 和 “lastBlock” 的 哈 希 值 不 相等 ， 就 证 明 检 测 到 了 分 又 。 
此 时 到 本 地 数据 库 查 找 分 又 点 区 块 ， 由 于 SB 和 4B 区 块 还 没有 存储 到 本 地 ， 自 然 就 不 可 能 获取 到 ， 
这 样 在 查找 的 过 程 中 只 能 通过 访问 以 太 坊 的 “eth getBlockByHash” 接口 来 获取 4B 和 5B 区 块 。 
最 终 在 获取 到 AB 区 块 的 时 候 ， 根 据 AB 区 块 的 父 块 哈 硕 值 Cparent hash) 从 数据 库 中 获取 到 了 3A 
区 块 ，3A 区 块 就 是 分 又 点 区 块 ， 然 后 程序 将 3A 区 块 到 6B 区 块 中 间 的 4A 和 SA 区 块 都 标记 为 分 
又 块 。 最 后 程序 进行 过 有 历 重 局 ， 从 3A 区 块 开始 ， 补 充 完 4B 和 5B 区 块 。 整 个 遍历 过 程 如 图 5-49 
所 示 。 

遍历 到 区 块 66，6B 的 "parent hash" 是 5B 的 ,而 


lastBlock 是 5A， 发 现 不 等 ， 出 现 分 义 。 
4B<-5B< -6B 部 分 是 由 最 优 链 同步 产生 的 。 


EX LER e | 
ES ES 
E, ES 


5-49 ”遍历 出 现 分 又 情况 
4. 编写 获取 分 义 点 区 块 的 代码 
根据 前 和 面 的 思路 分 析 ， 我 们 可 以 给 出 实现 获取 分 叉 点 区 块 代码 的 思路 : 


CD 根据 检测 出 的 分 叉 块 的 父 块 哈 希 值 (parent hash) 进行 本 地 数据 库 的 查找 ， 若 存在 则 直 
接 返 回 。 

(2) 如 果 本 地 数据 库 不 存在 ， 那 么 调用 请 求 以 太 坊 接口 获取 父 区 块 〈 简 称 为 父 块 ) 信息 。 

(3) 在 获取 到 了 父 区 块 后 ， 继 续 往 上 递归 查看 该 父 区 块 的 父 区 块 ， 直 到 在 本 地 数据 库 找到 分 
LAKH, 
// 获取 分 叉 点 区 块 


func (scanner *BlockScanner) getStartForkBlock(parentHash string) (*dao.Block, 
error) ( 


// 获取 当前 区 块 的 父 区 块 ， 分 又 从 父 区 块 开始 


parent := dao.Block() // 定义 一 个 block 结构 体 实 例 ， 用 来 存储 从 数据 库 查 询 出 的 区 块 信息 
// 下 面 使 用 xorm 框架 提供 的 函数 ， 根 据 block hash 去 数据 库 获 取 区 块 信息 ， 等 同 于 SOL WA: 
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// select * from eth block where block hash-parentHash limit 1; 
., err := scanner.mysql.Db.Where("block hash-?", parentHash).Get(&parent) 
if err == nil && parent.BlockNumber !- "" { 


return &parent, nil // 本 地 存在 ， 直 接 返 回 分 又 点 区 块 


// 数据 库 没有 父 区 块 记录 ， 准 备 从 以 太 坊 接口 获取 


parentFull, err := scanner.retryGetBlockInfoByHash (parentHash) 
if err !- nil { 


return nil, fmt.Errorf ("分 又 严重 错误 ， 需 要 重启 区 块 扫描 $s", err.Error()) 
} 
// 继续 递归 往 上 查询 ， 直 到 在 数据 库 中 有 它 的 记录 


return scanner.getStartForkBlock(parentFull.ParentHash) 
] 


// 输出 日 志 


func (scanner *BlockScanner) log(args ...interface{}) { 
TMCS PEINE INST gSa) 
} 


Ht, “retryGetBlockInfoByHash” FR Zip Zi — P664 x iss] “eth getBlockByHash” 的 改 
hi e 2c, 之 所 以 禹 重 试 策略 ,是 为 了 防止 因为 网 络 或 节点 原因 导致 一 次 获取 出 错 而 使 整个 程序 被 中 
止 。 对 于 远程 服务 导致 的 针 误 ， 可 给 予 请 求 重 试 。 图 5-50 就 是 由 于 远程 服务 针 误 后 重 试 获取 成 功 
的 截图 。 


Run: = TestBlockScanner Start in eth-relay 


> © & » QW Tests failed: 1 of 1 test - 4m 11s 682 ms 


由 scan block finish 


targetNumber J 
RAL HHS E BEA AR 


获取 区 块 信息 ， 重 试 一 次 

获取 区 块 信息 ， 重 试 一 次 

获取 区 块 信息 ， 重 试 一 次 

闭 取 区 块 信息 ， dis : 重 试 后 ， 最 终 获 取 成 功 
targetNumber i; 

scan block start ==> number: 6919338 hash:  0xea7c94ba9baa2d6a690dc4 
scan block finish 


图 5-50 ”区 块 信息 获取 的 重 试 策略 


重 试 策略 函数 有 两 个 包括 根据 区 块 号 获取 信息 的 函数 以 及 根据 区 块 哈 希 值 获取 信息 的 函数 。 
它们 的 实现 代码 分 别 如 下 : 
// 区 块 号 存在 ， 信 息 获 取 为 空 ， 可 能 是 以 太 坊 网 络 延 时 问题 ， 重 试 策略 函数 
func (scanner *BlockScanner) retryGetBlockInfoByNumber(targetNumber *big.Int) 


(*model.FullBlock, error) { 
Retry: 
// 下 面 调 用 以 太 坊 请 求 者 ethRequester 的 GetBlockInfoByNumber 函数 
fullBlock, err := scanner.ethRequester.GetBlockInfoByNumber (targetNumber) 
if err !- nil 1 
errInfo := err.Error() 
if strings.Contains(errInfo, "empty") | 
// 区 块 号 存在 ， 信 息 获 取 为 衬 ， 可 能 是 以 太 坊 网 络 延 时 问题 ， 直 接 重 试 
scanner.1og(" 获 取 区 块 信 息 ， 重 试 一 次 . . . . . ", targetNumber.String()) 
goto Retry 
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return nil, err 


} 
return fullBlock, nil 


) 
// 区 块 哈 希 值 存在 ， 信 息 获 取 为 空 ， 可 能 是 以 太 坊 网 络 或 节点 问题 ， 重 试 策略 函数 


func (scanner *BlockScanner) retryGetBlockInfoByHash (hash string) 
(*model.FullBlock, error) { 
Retry: 
// 下 面 调用 我 们 以 太 坊 请 求 者 ethRequester 的 GetBlockInfoByHash 函数 
fullBlock, err := scanner.ethRequester.GetBlockInfoByHash (hash) 
if err t= nil [( 
erriInfo := err.Error() 
if strings.Contains(errInfo, "empty") 
// 区 块 号 存在 ， 信 息 获 取 为 空 ， TER DUC RARE EHI E BOR IX 
scanner .1log(" 获 取 区 块 信 息 ， 重 试 一 次 . . . . . ", hash) 
goto Retry 
} 


return nil, err 


} 
return fullBlock, nil 


5. 获取 要 进行 扫描 的 区 块 号 
区 块 号 在 整个 遍历 流程 中 充当 了 数据 请 求 的 前 置 条 件 ， 需 要 根据 不 同 的 情况 正确 设置 区 块 号 
的 值 。 一 般 要 考虑 的 情况 有 : 
(1) 程序 首次 启动 时 ， 应 该 如 何 赋值 。 
(2) 程序 第 N (N > 1 时) 次 启动 时 区 块 号 的 取 值 。 
(3) 程序 运行 中 ， 区 块 号 的 值 应 该 如 何 变 化 。 


结合 前 面 “ 区 块 事件 监听 ”的 整体 流程 图 可 知 ， 首 先 需 要 从 数据 库 中 得 找 出 上 一 次 成 功 明 爵 
的 且 不 是 分 叉 的 区 块 ， 然 后 判断 是 否 存 在 区 块 的 数据 : 如 果 区 块 有 数据 ， 那 么 对 应 上 述 的 第 (2) 
点 ， 这 是 程序 的 第 N 次 局 动 ; 如 果 区 块 没 有 数据 ， 是 空 区 块 ， 那 么 证 明 程 序 是 首次 月 动 。 

实现 上 述 第 (1) 与 (QD 点 的 代码 如 下 ， 请 务必 跟随 代码 中 的 注释 进行 理解 : 


// 初始 化 : 内 部 在 开始 遍历 时 赋值 lastBlock 
func (scanner *BlockScanner) init() error { 
// 下 面 使 用 xorm 提供 的 数据 库 函 数 来 从 
// 数据 库 中 寻找 出 上 一 次 成 功 裔 历 的 且 不 是 分 叉 的 区 块 
// 等 同 于 SQL: select * from eth block where fork=false order by create time desc 
Timiti? 
_, err := scanner.mysql.Db. 
Desc("create time"). // 根据 时 间 降 序 
Where("fork = ?", false). 
Get (scanner.lastBlock) 
if err !- nil { 
return err 
} 
if scanner.lastBlock.BlockHash == "" { 


// 区 块 哈 希 值 为 空 ， 证 明 是 整个 程序 的 首次 局 动 ， 那 么 从 节点 中 获取 最 新 生成 的 区 块 
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// GetLatestBlockNumber 获取 最 新 区 块 的 区 块 号 
latestBlockNumber, err := scanner.ethRequester.GetLatestBlockNumber () 
if err !- nil { 
return err 


} 
// GetBlockInfoByNumber 根据 区 块 号 获取 区 块 数据 
latestBlock, err := 
scanner.ethRequester.GetBlockInfoByNumber (latestBlockNumber) 
if err !- nil { 
return err 
} 
if latestBlock.Number -- "" 
panic(latestBlockNumber.String()) 


} 

// 下 面 是 给 区 块 裔 历 器 的 lastBlock 变量 赋值 

scanner.lastBlock.BlockHash = latestBlock.Hash 

scanner.lastBlock.ParentHash = latestBlock.ParentHash 

scanner.lastBlock.BlockNumber = latestBlock.Number 

scanner.lastBlock.CreateTime = 
scanner.hexToTen(latestBlock.Timestamp).Int64() 

scanner.lastNumber - latestBlockNumber 

) else ( 


// 区 块 哈 希 值 不 为 空 ， 证 明 不 是 首次 启动， 而 是 后 续 的 启动 
Scanner.lastNumber,  - 
new(big.Int).SetString(scanner.lastBlock.BlockNumber, 10) 
// 下 面 加 1， 因 为 上 一 次 数据 库存 的 是 已 经 遍历 完了 的 区 块 ， 接 下 来 是 它 的 下 一 个 区 块 
scanner.lastNumber.Add(scanner.lastNumber, new(big.Int).SetInt64(1)) 
} 


return nil 


) 
// 定义 一 个 将 十 六 进 制 数 转 为 十 进 制 大 数 的 函数 


func (scanner *BlockScanner) hexToTen(hex string) *big.Int { 
if !strings.HasPrefix(hex,"Ox") | 
ten, _ := new(big.Int).SetString(hex, 10) // 本 身 就 是 十 进 制 字 符 串 ， 直 接 设置 


return ten 


} 
ten, _ := new(big.Int).SetString(hex[2:], 16) 
return ten 


第 GO 点 的 情况 ， 需 要 每 次 和 最 新 区 块 号 进行 比较 。 在 代码 中 首先 要 获取 公 链 上 当前 最 新 生 
成 区 块 的 区 块 号 ， 假 设 它 是 A， 然 后 使 用 A 和 在 初始 化 时 设置 “lastBlock” 中 的 区 块 号 B 进行 比 
较 ， 可 能 会 出 现 的 情况 有 : 
e A-B, 说 明 B 过 大 ， 此 时 要 循环 获取 最 新 的 A， 直 到 A > B 才 开 始 遍 历 。 一 般 来 说 ， 这 种 
情况 很 少 出 现 ， 除 非特 定 地 设置 要 从 某 个 高 度 开 始 遍历 。 例 如 ， 当 前 最 新 区 块 高 度 是 5. AR 
么 故意 设置 从 8 高 度 才 开始 遍历 就 会 出 现 这 种 情况 。 

e A 2 B, 证 明 B 恰好 等 于 当前 的 最 新 区 块 高 度 或 者 比 最 新 区 块 高 度 要 小 ， 可 以 继续 从 B 开 
始 遍 历 区 块 。 


第 3 点 的 代码 实现 如 下 : 
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// 获取 要 扫描 的 区 块 号 


func (scanner *BlockScanner) getScannerBlockNumber() (*big.Int,error) { 
// 调用 以 太 坊 请 求 者 ethRequester 获取 公 链 上 最 新 生成 的 区 块 的 区 块 号 
newBlockNumber, err := scanner.ethRequester.GetLatestBlockNumber () 
if err !- nil { 
return nil,err 
} 
latestNumber := newBlockNumber 
// 下 面 使 用 new 的 形式 初始 化 并 设置 值 ， 不 要 直接 赋值 ， 
// 否则 会 和 lastNumber 的 内 存 地 址 一 样 ， 影 啊 后 面 的 获取 区 块 信息 
targetNumber := new(big.Int).Set(scanner.lastNumber) 
// 比较 区 块 号 大 小 
站 
if latestNumber.Cmp(scanner.lastNumber) < 0 { 
// 最 新 的 区 块 高 度 比 设置 的 要 小 ， 则 等 待 新 区 块 高 度 >= 设置 的 
Next: 
tor i 
select { 
case «-time.After(time.Duration(4 * time.Second)): // 延 时 4 秒 重 新 获取 
number, err := scanner.ethRequester.GetLatestBlockNumber () 
if err == nil && number.Cmp(scanner.lastNumber) >= 0 { 
break Next // 跳出 循环 
} 


} 
} 
return targetNumber,nil // 返回 目标 区 块 高 度 


需要 注意 的 是 ， 函 数 “init” 的 调用 要 比 “getScannerBlockNumber” 早 ， 因 为 后 者 依赖 前 者 设 
置 好 的 “lastNumber” 。 

6. 实现 区 块 扫描 

扫 摘 区 块 使 用 权 函 数 就 是 上 述 我 们 实现 每 个 功能 的 集合 ， 其 执行 流程 请 参照 “区 块 事件 监听 ” 
的 整体 流程 图 。 

扫描 函数 的 完整 代码 如 下 所 示 : 
// 扫描 区 块 


func (scanner *BlockScanner) scan() error { 
// 获取 要 进行 扫描 的 区 块 号 
targetNumber,err := scanner.getScannerBlockNumber () 
if err !- nil { 
return err 
} 
// 使 用 具有 重 试 策略 的 函数 获取 区 块 信息 
fullBlock, err := scanner.retryGetBlockInfoByNumber (targetNumber) 
if err !- nil { 
return err 


} 
// 区 块 号 加 1， 在 下 次 扫描 的 时 候 ， 指 癌 下 一 个 高 度 的 区 块 
scanner.lastNumber.Add(scanner.lastNumber, new(big.Int).SetInt64(1)) 
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// 因为 涉及 两 张 数 据 表 的 更 新 ， 我 们 需要 采用 数据 库 事务 处 理 

tx := scanner.mysql.Db.NewSession() // 开启 事务 

defer tx.Close() 


// 准备 保存 区 块 信 息 ， 先 判断 当前 区 块 记录 是 否 已 经 存在 
block := dao.Blockí)] 
., err = tx.Where("block hash-?", fullBlock.Hash).Get(&block) 
if err == nil && block.Id == 0 { 
// 不 存在 ， 进 行 添加 
block.BlockNumber = scanner.hexToTen(fullBlock.Number).String() 
block.ParentHash fullBlock.ParentHash 
block.CreateTime scanner.hexToTen(fullBlock.Timestamp).Int64() 
block.BlockHash = fullBlock.Hash 
block.Fork - false 
if _, err := tx.Insert(&block); err != nil [ 
tx.Rollback() // 事务 回 滚 


return err 


} 


} 
// 检查 区 块 是 否 分 又 
if scanner.forkCheck(&block) { 
data, := json.Marshal(fullBlock) 
scanner.log("4]X! ", string (data)) 
tx.Commit() // 即使 分 又 了 ， 也 要 把 保存 区 块 的 事务 提交 
scanner.fork = true // 发 生 分 又 
return errors.New("fork check") // 返回 错误 ， 让 上 层 处 理 并 重启 区 块 扫 描 


} 
// 解析 区 块 内 的 数据 ， 读 取 内 部 的 “transactions” 交易 信息 ， 分 析 得 出 各 种 合约 事件 
scanner.log( 
"Scan block start ==> ", "number: ", 
scanner.hexToTen(fullBlock.Number), "hash: ", fullBlock.Hash) 
for index, transaction := range fullBlock.Transactions { 
// 下 面 的 打印 操作 模拟 自 定义 处 理 。 对 于 每 笔 tx， 我 们 是 完全 可 以 进一步 从 里 面 提取 信息 的 ! 


scanner.log("tx hash ==> ", transaction.Hash) 


if index -- { 
// 因为 每 个 区 块 打包 的 交易 数目 是 不 同 的 ， 为 了 减少 显示 的 信息 ， 这 里 控制 只 打印 5 笔 
break 
} 
} 
scanner.log("scan block finish \n=================") 
// 数据 库 保 存 交 易 信 息 
if _, err = tx.Insert(&fullBlock.Transactions); err !- nil [ 


tx.Rollback() // 事务 回 滚 


return err 
} 
return tx.Commit() // 提交 事务 


因为 获取 的 区 块 数据 要 保存 到 数据 库 中 ， 在 区 块 遍历 完成 后 ， 必 须 将 所 有 交易 记录 的 数据 保 
存 到 数据 库 .这 个 过 程 涉及 两 张 不 同 数据 表 的 插入 操作 ,为 了 防止 一 方 插入 失败 而 导致 数据 不 对 称 ， 
在 代码 中 使 用 了 MySQL 事务 操作 进行 数据 插入 。 这 样 做 的 好 处 是 在 错误 发 生 的 时 候 可 以 及 时 地 进 
行 数 据 回 深 。 
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7. 局 动 区 块 扫描 
在 完成 了 最 后 的 区 块 扫 摘 函数 “scan” 后 ， 还 需要 一 个 局 动 整个 扫 摘 流程 的 图 数 ， 即 局 动 函 数 
4Start()" . 
局 动 函数 的 执行 步骤 如 下 : 
(1) 首先 为 互 斥 锁 上 锁 ， 防 止 多 协 程 操作 同一 个 “BlockScanner” 实 例 去 局 动 多 次 “Start” 
PR rd dft e 
(2) HEITAN EE ASAKA. PRR E—2DO 7 S UJRS AEZ) CPC ERIS] XC o 
(3) 有 尼 动 “Go” 协 程 。 在 内 部 调用 “Scan” 扫 摘 图 数 ， 因 为 扫 摘 动作 不 能 阻塞 在 main 函数 
的 主 协 程 中 。 
(4) 在 进行 扫描 的 同时 ， 还 要 监听 “stop” 管 道 ， 以 捕获 停止 扫 摘 的 动作 指示 ， 以 及 在 检测 
到 分 又 事件 的 时 候 ， 重 新 进行 初始 化 前 置 数据 ， 随 后 继续 进行 扫描 。 
“Start()” 义 数 的 完整 代码 如 下 : 
// 整个 区 块 扫描 的 启动 函数 


func (scanner *BlockScanner) Start() error { 
scanner.lock.Lock() // 互 斥 锁 加 锁 ， 在 stop 函数 内 有 解锁 步骤 
// 首先 调用 init 进行 数据 初始 化 ， 内 部 主要 是 初始 化 区 块 号 
if err := scanner.init(); err !- nil 1{ 
scanner.lock.Unlock() // 因为 出 现 了 错误 ， 所 以 我 们 要 进行 解锁 
return err 
} 
execute := func() ( 
// scan 函数 ， 就 是 区 块 扫 描 函 数 
if err := scanner.scan(); nil !- err { 
scanner.log(err.Error()) 
return 
} 
time.Sleep(1 * time.Second) // 延迟 一 秒 开 始 下 一 轮 
} 
// 启动 一 个 go WEK HX ik 
go func() l 
for ( 
select ( 
case «-scanner.stop: // 监听 是 否 退 出 遍历 
scanner.log("finish block scanner!") 
return 
default: 
if !scanner.fork { 
// 进入 这 个 if 证 明 没 有 检测 到 分 又 ， 正 常 地 进行 每 一 轮 的 裔 历 
execute () 
continue 
} 
// Æ fork = true， 则 监听 到 有 分 又 ， 重 新 初始 化 
// 重新 从 数据 库 获 取 上 次 过 历 成 功 且 没有 分 叉 的 区 块 号 
if err :- scanner.init(); err !- nil { 
scanner.log(err.Error()) 
return 
} 


scanner.fork = false 
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} 
TO 
return nil 


} 


// 公有 函数 ， 可 以 供 外 部 调用 来 停止 区 块 裔 历 

func (scanner *BlockScanner) Stop() { 
scanner.lock.Unlock() // 解锁 
Scanner.stop <- true 


} 

至 此 ， 整 个 区 块 裔 历 器 的 代码 都 已 经 编写 完成 ， 全 部 编写 在 “block scanner.go” 文 件 中 。 接 
下 来 我 们 进行 壳 历 器 代码 的 测试 。 

8. 测试 区 块 扫描 器 


关于 区 块 扫 摘 需 的 测试 代码 ， 我 们 在 项 目 中 单独 新 建 一 个 "block scanner test.go” 文件 来 
编写 ， 如 图 5-51 所 示 。 


eth-relay => block scanner test.go 
ÉP Project ~ © 3-1- block scanner test.go 
eth-relay C^go 1.9\lgh\sro\eth: 工 队 — package main 
dao - 
Keystores 
model 
tool 
& block scanner.go 
S ETH RPC Client.go 
5 ETH RPC Requester.go 
$$ ethrpc test.go 


a 1l: Froject 
« 


> 
> 
> 
> 


5-5] 新建 测试 代码 文件 “block scanner test.go" 


根据 区 块 扫 插 费 结 构 体 的 定义 , 测试 代码 中 冯 先 要 定义 好 一 个 以 太 坊 “RPC” 请 求 者 和 数据 库 
连接 器， 再 根据 它们 去 初始 化 区 块 扫 摘 器。 整体 的 测试 代码 如 下 : 
// 单元 测试 : 区 块 扫描 器 ， 开 始 扫描 区 块 


func TestBlockScanner Start(t *testing.T) ( 
// 初始 化 以 太 坊 rpc 请 求 者 
mainNet := "https://mainnet.infura.io/v3/2e6d9331f74d472a9d47fe99f697ca2b" 
requester := NewETHRPCRequester (mainNet) 


// 初始 化 数据 库 连 接 器 的 配置 对 象 ， 记 得 修改 为 本 地 数据 库 的 参数 
option := dao.MysqlOptions(í 


Hostname: PIZTLUSUIIUS 
Port: We 
DbName: "eth relay", 
User: i a 
Password: "123490"; 
TablePrefix: "eth ", 


MaxOpenConnections: 10, 
MaxlIdleConnections: 5, 
ConnMaxLifetime: T3 
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} 
// 添加 数据 表 
tables := [l]interface(]í() 


tables = append(tables, dao.Blockí], dao.Transactioní]) 


// 根据 上 面 定义 的 配置 ， 初 始 化 数据 库 连 接 器 


mysql := dao.NewMqSQLConnector(&option, tables) 


// Wa Eis 
Scanner :- NewBlockScanner(*requester, mysql) 
err := scanner.Start() // 开始 扫描 
if err !- nil { 
panic (err) 
f 
// 使 用 select 模拟 阻塞 主 协 程 ， 等 待 上 面 的 代码 执行 ， 因 为 扫描 是 在 gorutine 协 程 中 进行 的 
select (] 


运行 单元 测试 ， 可 以 看 到 控制 全 开始 输出 表 历 区 块 的 数据 ， 如 图 5-52 所 示 。 


Run:  - TestBlockScanner Start in eth-relay > 
pO» © Tests failed: 1 of 


test - 3m 85 824 ms 


«4 go setup calls» 
; [xorm] [info] 2018/12/21 20:14:52. Arr PING DATABASE m 
scan block start --» 
tx hash ==> MM T E d ce1555ba8f6420edAf&d 
hash ==>  ex96076fbb84A4dcdbAc251b2cfcc253608cb168bcfb8486f3bc162a2a49cd3fcb2 
hash ==>  0x26830c1512683b1a244d94bbb863f405f112958840690ce699a8b632e71cc906 
hash ==>  8x3c3624272586d45c40fca637dae3fbbs8de01a9cc7fdasfdeifo7815fc1981e4 
hash ==>  exi459cfbofio2af542784ea9bd954521dcc44ad39501f6305412bbff19dfa8509 
hash ==> xc64ddf2541c8d7b9dc3d0e6073afdc7157f9b7b2251ec7f86fbaed7dcf440fcc 
scan block finish 


scan block start ==> number: 6926561 hash: 0x1c7876e7b4d1be07919db4a3c882441d7413b93cec35a7d10f645AcA6d798a310 
hash 0x2429f043f24a2079bec637e849ec743a97344424d704c87b87be989517c544c2c5 
hash 6xe648c8c630e3026c1dbd2c70ee28e15fd804762a044408c32d2fd29f1382dbf6c 
hash 0x7f23d7861cf2774176c6f7a010a4729802a822a7b83f5d9351f43dae0de78ac799 
hash 0x5ad580aala0bea8e6ba7572233febe992e80010944d82a21a76de6587cf8202b3 
hash 0x2639374b89884f52eadf9ei1c6d4Ad6a24218b0f6924bh7ed0e7efb8a714440fe82 
6x140c9aab5127549c48a934a3521c62962a77652a3279c8ba63230e75f89abe2co0d 


图 5-52 gWpeBud-üseml. PERA h AI Hos 


对 应 地 ， 通 过 Goland ISI] ^ Terminal" HEA $1 MySQL ŽE Aim, fri] “eth block” 数 据 
表 的 数据 ， 我 们 也 能 看 到 区 块 数据 已 经 成 功 存储 进去 了 〈 见 图 5-530 ， 查 询 命令 是 : 


select * from eth block; 


sql»|select * from eth block, 


6926560 
6926561 
6926562 
6926563 
6926564 
6926565 
6926566 
6926567 
6926568 
6926569 
6926570 
6926571 
6926572 
6926571 
6926573 
6926574 


十 
0xd23b42d6bcbb462f403e631684478ce8bcdd437fbby90c58ff66a3l5ebbl3fad 


0xlc7876e7b4d1lbe07919db4a3c882441d7413b93cec35a7d10£6454c460798a10 
0x019f9e23fbcbd07cfd255ab06e06b6d783a4bd19e745856e99df39a7d49176e3 
0x88a3d7577ac72063e233b61d6b5c25d£883c98b4133b0515d00c21d27dbe9183 
0xc392bdlfb5b26a8aelb4d?7174c90f0014a45e6aclb1cc981751a7c3f350b84a2741 
0x997e704f5e4adal36ebbf88e46f8b506c200792cc3829a0b90d7ec92cce5badlc 
0x9c323c90924466843fd060740bf 4c2a25bd79bf47ble8de754dd200e1385b 1b5f 
Ox9f3b65bdb8c3ccbd?74918a39b49a81019c53£2918689b838bf36f 155aecd97c01 
0xf4710eflf6eba72c05f9a16b51cc5113bcc9d76709be17994017e8120800a797 c 
0xb7996973e39c89c3353d0b3229b6de1074a5be9c931594fe3d47b3caffce374c7 
0x2cbe1806d462bc60a29821b2dd16cb7b72e131£5202b49a1295c3b584a2b056c600 
0x0532afedebf62e6e1500fd5daefc9163c4c509291899f1b477c3e590f4aa5bee5b4 
0x46e45e38db0620cd984114a01045176bfa953f0f7ce39e8b728b0e6131aeef56 
0xcclbalbd8062191d7ae313128919589271£244d3828ab376d73e076409dd3179d7 
0x4aa2a705bef343bd93aa8c30009a71c68dbf0d660f99179clafdaab0a94fb8584 
0x01062731c1ea444760£8366d79£c23797538aace2c9a117612£6257b4a37bba6 


5-53. ”在 数据 库 控制 台 输 入 命令 查看 数据 表 中 被 过 历 了 的 区 块 信息 
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继续 观察 程序 的 运行 ， 一 段 时 间 后 ， 就 会 看 到 检测 到 的 分 又 区 块 的 日 志 输 出 。 如 图 5-54 所 示 ， 
“69b0ec” 的 十 进 制 是 “6926572”， 在 读 取 “6926572” 号 区 块 的 时 候 检 测 到 分 又 ， 然 后 往 上 递归 
找到 分 叉 点 区 块 是 “6926570”， 那 么 在 “6926570” 到 “6926572” 范 围 内 的 区 块 就 是 分 叉 区 块 ， 
即 “6926571” 是 分 义 区 块 。 此 时 程序 跳出 遍历 ， 开 始 重 新 初始 化 ， 从 数据 库 中 获取 出 上 次 遍历 成 
功 的 且 没 有 分 义 的 区 块 “6926570”, 然后 “6926570” 累 加 1, 为 “6926571”, 程序 便 从 “6926571” 
继续 开始 往 下 过 历 。 


scan block start ==>| number: 6926571 hash: oxo532afedebf62e6e1seofdsdaefc9163cac5d9291899fb477c3e590f4aaseesa] 
tx hash ==> @x65782382e687aad4113c393604ffd6efa9540ef6d112e91da6@f1e3d817713006 
tx hash ==>  ex676f3cfaac726254c4c9a50a1e1b79d64b4ee9d9dc6a71cec16696176b4bd077 
tx hash ==> @x3d8dffbb9ace05f0eae4f673f979d16351dd8c33f81845a3da25f15d1cb65bcb 4« A nonrrii BATT 

第 一 个 6926571 是 分 义 区 块 ， 
tx hash ==>  0x83a8aa91d961c57d3e977a907e6581c8a249a2fbd12f700b5878b51805141a220 ... zr 日 m 
tx hash ==> exeaddisoefaeda342bs3ds460021c30bsfoesdcodefd2f7a45ci2decccs42eoaca 它 的 hash ji Pif 54 iE- 
tx hash ==> 6x9d549e3ca012121524e9c9e04a91c52f0b82af04e77f09567e34befddo4fasda T Xrid fA EJRIETEJDER D 
scan block finish d7 字符 结尾 


"hash":"e@x46e45e38db856528cd984114a81845176bfa953fef7ce39e8b728b8@e6131aeef56","parentHa 
ork chec 

scan block start ==>| number: 6926571 ]hash: oxcc1ba15da06219147ae3f312891958927f24d3828ab376d73e076ada3f79d7| 
tx hash ==> 6x65783382e687aad4113C39364ffd6efa9540ef6d112e91da66f1le3d817713066 

tx hash ==>  0x6188ac03f70376c6dcf647b18b37f4353f37b5ad28dddc3de5b2f3c69c97A4ffa 

tx hash ==>  0x852fe2ee1472cdd86e3b65d42437556aed22bbeddbf 38cdc3e6a440ff3175a93 

tx hash ==> x17a1c823e3852eeeeb7e57d0202edacc4Ad3ebi1a99ec9914bee956f8571888276f 

tx hash ==> x3b718c93ca3bc6befcdd5dOeaeaddfb9176cb&85cbcef375535a1bef1106564de 

tx hash ==> 6x20342f9e3df0389f7f2f625de95d6d2a5582c2b806ddd20e8e7015128a61aad0 

scan block finish 


5-54 区 块 遍历 检测 到 分 叉 块 后 的 重新 纠正 扫描 所 产生 的 日 志 
打开 以 太 坊 区 块 链 浏览 器 ， 查 询 “6926571” 号 区 块 的 哈 希 值 是 否 是 以 “d7” 结 尾 ， 以 验证 以 
“54” 结 尾 的 是 分 又 区 块 ， 如 图 5-55 所 示 。 
Etherscan 


LOGIN Search by A 


HOME BLOCKCHAIN ~ 


Overview Comments 


Block Information OQ © 


Height: 6926571 


TimeStamp: 15 mins ago (Dec-21-2018 12:15:24 PM +UTC) 


Transactions: 53 transactions and 113 contract Internal Transactions in this Block 

üxcc1ba1 sd806219107ae3131289195892712403828ab376a73e076406adr7907 | 
Parent Hash: 0x2cbe1806d462bc60a9821b20d16cb7b72ef315202b49a1295c3b84a2b056c6D0 
Sha3Uncles: 0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a1421d40d49347 


Mined By: 0xea674fdde7 14fd979de3edf0f56aa9716b898ec8 (Ethermine) in 2 secs 


5-55 ”到 区 块 链 浏览 器 查询 以 验证 区 块 扫描 出 的 分 又 区 块 是 否 正确 


同时 查看 “eth_ block” 数 据 表 ， 验 证 是 否 已 经 将 分 叉 的 区 块 标记 为 分 又 状态 ， 图 5-56 所 示 是 
已经 成 功 将 哈 希 值 结尾 为 “54” 的 “6926571” 号 区 块 标记 为 分 又 区 块 的 情况 。 

此 外 ， 我们 再 通过 MySQL 命令 来 查看 “eth transaction” 数 据 表 中 是 否 存储 了 交易 信息 〈 见 图 
5-57) 。 具 体 命令 是 : 

select * from eth transaction limit 5; //limit 5 的 意思 是 只 选 出 5 条， 因为 交易 信息 比较 多 。 
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select * from eth block; 


-一 -一 一 一 一 一 一 一 一 一 


一 一 十 一 


| block number | block hash 


6826560 
6926561 
6926562 
6920583 
6926564 
6926565 


| Oxd23b42d86bcbb452f 4030631684478 ce8bcddi37fbb T00c58ff86a3153bb13fad | 0xd49ddcq0edc3bie7al73c7fab8gldu0e701563blc2a606ef98dced00cb9o7203T7c5 | 


| Ox1cT8T6e?7b4dlbe07919db4a3c822441d7413b93cec3baTdl0f6454c464d798a1l0 | üxd23b42dbbcbb462£403e6318844T8cegbcdd437ibbT90c58£466a315ebbl3fad | 


| 0x019f9e23fbcbd0Tc f d2E5abÜGe0Bb6d783a4b5d19e745856e0d£239a7d49f76e3 
| 0x88a3d7577ac72063e2383b61d6b5c25df883c98b4183b0515d0Dc21d27dbe 0783 
| 0xc382bd1£526a9221bád7174c8f10014a45662c151cc981751a7c82350b08422741 
| ozx997e704f5ed4ada136ebbf88e46fgb506c209792cc38329an0b90d7ec92cce5adlc 


| parent hash 


| Oxic?876e7b4d1be07819db4a3c882441d7413b03cec35a7d1016454.c 4687882 10 
| 0x018£6e231bctbd07cfd255abÜBe06b6d7835 4bd19e 7458566001305 704017663 
| 0x88aSd7517ac72063e233b6 1d6b5c25df883c08b4133605 15d00c2182 7dbe9183 
| üxc382bdif526aDaelb4d7174cB£0014a4568ac151cc981751a7c3f£350584a2741 


-------------------------------------------------------------------+--------------------------------------------------------------------+-------------+------ 十 


| creaie time | fork | 


1545394475 
15453944802 
1545394498 
1545394503 
1545394506 
1545394516 


1545394520 
1545394549 


| 0x8c323:0924466843f 106074051 4c2a25bdTOb f 47ble&Rde754dd200e1385b1b5* | 
| 0xG13b65d58cSccbd? 49 18a39b4938 1020:5312918689b838b f 36? 155aacd97 c01 


üxa07eT0415e4adalS6ebbf38e4d6f8b50A8c20070266332808 0bOG0d 76602 ccebadic 
üxgc323cO902446684S1d0607 10bf4c2Za2ob d? 9b £ATb lo8de 754dd2008 1385b 1bbf 


6926566 
6926567 
üxSf3bb5d58c3ccbd?4918a39b49a8l1üf8c53£2818589b5B38b£36f1552ecdWTcl1 


6926568 1545394565 


| 0xb7996973e39c89c3353d0b3229b6del074a5e9c931594fe3d47b3caffce374c7 | Oxf4?10eflfóeba?2c0bf0al8b51ccbll3bccOd76700b6170040176120800aT97c 


Qxb7996973e39c89c3353d0b3229b6duel07da5e9c93159dfe3dd4fb3caffce37dc7 


1545304567 
1545394582 
1545394584 
1545394620 | 
1545394584 | 
1545394529 | 


6026560 
6026570 
65326572 
6026571 


| 
| ozfd4710eflf6eba72c05f9al6b5lcc5113bccgd76709bel7994a017el20300a?97c | 
| 
| 


| 0xz2cbel1806qd462bc6059821b2dudal6cb7b72ef3152D2bd49a1295csb8da2b056c600 

| 0z0532afsqebfi62e6s1500fq5dqaesfc9163cdc5d9291899fb477c3e590f4a 
| Ox46e45e38db0620c4384114a01045176bfa953f0f7ce39e8b728b0e6131aeefbB | 
| Oxccibal5ds062191d7303:31239105802712443828ab376d7380764004d3f79d7 | 


üxZcbelSübdé5Zbc5UaU821bZddlbcbTbiZefS£520Zb429alz295c3b854aZb05b5cbU 
üxcclbalbd8062191dTae3131289105832712433828ab37507ae016408 0831 T9d7 
üx2cbel806d4620c6020821b2ddl16cbTb T28f S£5202b4931205c3b8432p056c600 


6926573 | 0x4aa2a705e£343bd93aaSc30009a?1c6Sdbiüd560£991T0clafdaabÜag4fbB584 | 0x45e45e38db0620cd9841l4a010451T6bfa953f0fTce39e8b728b0ə6l3laeef56 | 


| 6926574 | 0x01062731c1ea4447e0£8366d79f£c23707538aace2c0af17612£6257b4a37bba6 | Oxdaa2a705ef343Jbd03aaBc3000GaTicóSdbfÜd660:931790c1afdaabÜaD4fb8584 | 1545394551 | 


二 -一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 十 


5-56 ”在 数据 库 控制 台 查 看 分 又 区 块 是 否 被 正确 地 打上 了 标记 


sql? 


| nonce | block hash 


gas price 


十 
0x6d63f9dc30a3ce927f9ac8c5c58bc0a78b9006592dabldd878b4c6a288c470cc | Oxl242 | 0x568fd7lcdduc2843c3e22 
0x8cd647dae5138848ebdaglbg9c05de30722c2865e | 0xa53ebae5cb000 | ox4800000000 | 0x5208 | Ox 


0x07df98e87d7b4a22305dble6cO00afbflaf664c06291905594cb8241945p86d22 | Oxld59 | Ox568td71cddc2843c3e22 
0x027282a8d16c26b6dc28552d3d3727a2eb332515 | (xa53e5ae5cb000 | Oxd4800000000 | 0x5208 | Ox 


| Ox5681d71cddc2843c3e22 
| 0x174876e800 | Üxcb9c | 0xa9059cbb 


0xe9745b43b1906826085d3dc31224993251a904206ff7a6b5b863092096a663bc | Oxb8 


Üzfb28cbd984d3/791c9250152bdS8dfbdf38ÜeZa3b3c | UxU 
a7af9Tc0000 | 

Ox2e52c38f2951f56d0670817df7db9a9c3e231addledc7f94f37ed62f606336c2 | 0xl | Ox568fd71cddc2843c3e22 

ÜxTb5bcf82fabbbbl&53b8d2d05086b6379e1ac02b | 0x6737139e3e800 | Oxl2a05i2000 | Ox5208 | Ox 


0x4954625b3dfc42ffb6ab4605fbdlbbc6a2b7b6ecUb18709fb5148cfd2b394b5e | Uxl6484 | Ux568id7lcddc2843c3e22 
2 d LM | 0x6ef3f224033f8000 | Ox1087ee0600 | Ox15f90 | Ox 


5-57 ”在 数据 库 控 制 台 查看 交易 保存 表 是 否 有 数据 
由 图 5-57 可 以 看 到 ， 交 易 信 息 完 整地 被 存储 了 下 来 。 其 中 的 “input” 子 段 就 售 有 交易 的 参数 
数据 ， 进 一 步 分 析 它 ， 可 以 实现 很 多 需求 的 功能 。 
全 此 ， 整 个 区 块 遇 历 器 测试 通过 。 


5.3.5 理解 监听 区 块 事件 


在 实现 了 区 块 扫描 器 后 ， 我 们 已 经 能 够 从 区 块 中 成 功 地 获取 到 每 笔 交 易 的 数据 。 

我 们 前 面 提 到 的 要 实现 的 监听 区 块 事件 ， 包 含 “transfer” 等 ， 主 要 就 是 从 交易 数据 的 “input” 
字段 中 解析 出 来 的 ， “input” 其 实 就 是 “data”。 我 们 知道 ， “data” 字 段 的 前 10 个 字符 是 由 智能 
合约 的 函数 名 称 转化 而 来 的 “methodId”， 这 就 意味 看 ， 从 “input” 提 取 前 10 个 字符 来 和 对 应 函 
数 的 “methodId” 进 行 对 比 ， 就 能 找 出 当前 交易 所 调用 的 智能 合约 图 数 ， 从 而 实现 事件 的 监听 。 与 
此 同时 ， 对 应 函数 的 参数 就 是 “input” 后 面 的 部 分 数据 ， 对 应 转换 即 可 。 
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例如 ， 我 们 知道 “transfer” 的 “methodId” 是 “0xa9059cbb”， 此 时 遍历 区 块 的 交易 数据 时 获 
取 到 一 笔 交 易 的 “input” 数 据 : 

0xa9059cbb0000000000000000000000003faa6c0794b47100aaef42ea93cc03e3f1c991f7 
00000000000000000000000000000000000000000035af1c0cba270aea800000 

截取 上 面 这 个 “input” 的 前 10 个 字符 ， 即 “0xa905$9cbb”， 再 与 “transfer” 的 “methodId?” 
对 比 ， 发 现 是 一 样 的 ， 即 证 明 这 笔 交 易 调 用 了 智能 合约 的 “transfer” 函 数 ， 是 一 笔 转 账 交 易 。 

图 5-58 所 示 是 从 交易 数据 中 解析 出 监听 事件 的 整体 流程 图 。 
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input 字段 
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进行 对 比 


Yes 
是 否 匹 配 
触发 事件 分 发 


5-58 ”从 交易 数据 中 解析 出 事件 的 设计 流程 图 
5.4 小 结 


本 章 使 用 第 4 章 中 所 实现 的 绝 大 部 分 以 太 坊 RPC 接口 请 求 函数 ， 采 用 Go 语言 实现 了 一 个 强 
大 的 中 继 服务 文 持 程序 。 

本 章 内 容 也 可 以 说 是 前 几 章 内 容 的 综合 运用 ， 其 中 还 介绍 了 如 何 通 过 编程 实现 区 块 的 分 又 检 
测 ， 同 时 拓展 性 地 讲解 了 分 叉 区 块 数据 的 存储 回 深 。 

由 于 以 太 坊 中 继 是 偏 问 于 后 端 服务 的 , 因此 在 整体 实现 过 程 中 涉及 了 MySQL 数据 库 的 知识 以 
及 一 些 后 端 框 染 的 使 用 , 但 是 并 不 复杂 。 在 真实 的 业务 场景 中 ,中 继 内 部 还 可 以 加 入 其 他 中 间 件 服 
务 ,， 比 如 将 区 块 解析 的 事件 存储 到 消息 队列 中 , 让 其 他 微服 务 读 取 或 使 用 等 , 以 实现 更 复杂 的 功能 。 
读者 可 目 行 答 试 。 


m ie 


由 于 工作 笃 忙 ， 因 此 编写 此 书 的 大 部 分 时 间 是 在 夜间 和 周末 。 从 开始 到 结束 ， 深 感 写 书 之 不 
易 。 这 是 我 的 第 一 本 书 ,， 对 于 书 中 的 每 一 字句 都 负 有 不 可 推 色 的 贡 任 ， 如 夺 书 中 还 有 内 容 未 能 做 到 
深入 细致， 还 请 读者 多 多 包涵 ， 并 且 欢 迎 大 家 和 我 交流 。 

最 后 ， 衷 心 祝愿 每 一 位 阅读 此 书 的 朋友 都 能 有 所 收获 。 
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本 书 源 代码 下 载 
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